# Tracigo

> AI-native development workspace. One workspace per feature — requirements, design, specs, code, and your AI agent — all in one place.

Tracigo is a desktop application (macOS) for software teams that replaces the fragmented tool stack of Jira + Confluence + Slack + Google Docs + GitHub with a single workspace per feature. It works with 14+ AI coding agents (Claude Code, GitHub Copilot, Cursor, Codex, Gemini CLI, Cline, Kiro, Aider, Goose, and more) — auto-configuring each agent to understand your project's requirements, designs, specs, and decisions without MCP servers, plugins, or manual setup.

## Core Concepts

- **Projects**: A codebase — one or more git repositories grouped together. Tracigo creates git worktrees for workspace isolation, never modifying your original clones.
- **Workspaces**: One unit of work (feature, bug fix, refactor). Each gets its own git branch, VS Code environment, terminal sessions, and artifact folder. Multiple workspaces run in parallel.
- **Artifacts**: Structured YAML documents in `.tracigo/` that capture requirements, designs, specs, test plans, security reviews, RCAs, release notes, and user guides. Created during work (not after), they serve as living documentation that AI agents read automatically.
- **Agent Integration**: Tracigo auto-writes instruction files in each agent's native format so every new session starts with full project context — no re-explaining.

## Key Capabilities

- Parallel isolated workspaces with dedicated git worktrees, VS Code instances, and terminals
- 8 built-in artifact types (Requirements, Design, Spec, Test Plan, Security, RCA, Release Notes, User Guide) plus custom types
- Real-time collaborative editing of artifacts with inline comments, status tracking, and version history
- Automated daily and weekly digests showing what moved forward, what's stuck, and what needs attention
- Full traceability chain: Requirements → Design → Spec → Code, with changelog `affects` fields
- AI agent session discovery, history, and one-click resume across all supported agents
- Setup scripts (`.tracigo/setup.sh`) for automated workspace bootstrapping
- Build tool and terminal monitoring for 30+ development commands

## Docs

- [Introduction](https://tracigo.ai/docs): Overview of Tracigo, the problem it solves, and core concepts
- [Getting Started](https://tracigo.ai/docs/getting-started): Create your first project, workspace, and artifact
- [Projects](https://tracigo.ai/docs/projects): Single-repo vs multi-repo, contributors, settings
- [Workspaces](https://tracigo.ai/docs/workspaces): Isolation, branches, lifecycle, parallel work
- [Artifacts](https://tracigo.ai/docs/artifacts): Types, YAML structure, changelog conventions, traceability
- [Collaboration](https://tracigo.ai/docs/collaboration): Real-time editing, comments, reviews, artifact status
- [Agent Integration](https://tracigo.ai/docs/agent-instruction-injection): How 14+ AI agents are auto-configured
- [Terminals & Sessions](https://tracigo.ai/docs/terminals): Agent tracking, build monitoring, session history
- [Setup Scripts](https://tracigo.ai/docs/setup-scripts): Automated workspace bootstrapping
- [Keyboard Shortcuts](https://tracigo.ai/docs/keyboard-shortcuts): All shortcuts at a glance

## Links

- [Website](https://tracigo.ai)
- [LinkedIn](https://linkedin.com/company/tracigo)
- [Twitter/X](https://x.com/tracigo)