Getting Started

This guide walks you through setting up your first project, creating a workspace, and creating your first artifact.

1. Create a project

Open Tracigo and click New Project. Select the folder where your code lives. Tracigo scans for git repositories and sets up the project.

  • Single repo? Point to the folder containing your repo.
  • Multiple repos? Point to the parent folder. Tracigo detects all repos inside it.

Your project appears in the sidebar. Click it to see the project page.

2. Create a workspace

From the project page, click New Workspace. Give it a name that describes the work — "payment-retry", "guest-checkout", "auth-migration".

Tracigo creates:

  • A new git branch for this workspace
  • A separate VS Code environment
  • An .tracigo folder for artifacts

Your workspace opens automatically. You'll see the Code tab with VS Code ready to go.

3. Switch to the Artifacts tab

Click the Artifacts tab in the top bar. If this is a new workspace, you'll see a brief introduction explaining what artifacts are.

Tracigo seeds your workspace with starter templates — typically REQUIREMENTS, DESIGN, and SPEC. These are empty shells waiting to be filled.

4. Work with your AI agent

Open a terminal in your workspace and start your preferred AI agent (Claude Code, Codex, Copilot, or any of the 13+ supported agents).

Your agent already has context about the artifact system — Tracigo configures this automatically. You can verify by asking your agent: "What artifacts exist in this workspace?"

Start a conversation about what you're building. Discuss requirements, explore approaches, make decisions. When you're ready to formalize something, ask your agent:

"Can you write this into the requirements artifact?"

The agent creates or updates the YAML file in .tracigo. You'll see the changes reflected in the Artifacts tab.

5. Review in the Artifacts tab

Switch to the Artifacts tab to see your artifact rendered with proper formatting. You can:

  • Expand any artifact to see its full content
  • Switch between Local and Shared mode — Local shows your working copy, Shared shows the team version
  • Edit directly in the UI if you prefer that over the agent

6. Share with your team

When you're ready for others to see your work, click Save on the artifact card. This publishes your artifact to the shared version where teammates can:

  • View the latest state
  • Edit together in real-time
  • Leave comments on specific sections
  • Change the artifact status (draft, in review, approved)

What's next

  • Artifacts — Deep dive into artifact types, YAML structure, and changelog conventions
  • Workspaces — How workspace isolation works, multi-repo setup, lifecycle management
  • Agent integration — How Tracigo configures your AI agents automatically