Projects

A project in Tracigo represents a software system — your codebase, your repositories, and all the workspaces where features get built.

Creating a project

Click New Project from the home screen. You'll:

  1. Name it — something that identifies the system: "payment-platform", "mobile-app", "api-gateway"
  2. Select a folder — point to where your code lives on your machine
  3. Confirm repositories — Tracigo scans the folder and detects git repos. For a single-repo project, that's one repo. For multi-repo, it finds all repos in the folder.

Tracigo clones nothing and modifies nothing in your existing repos. It creates worktrees (lightweight git checkouts) for each workspace, leaving your main branches untouched.

Single-repo vs multi-repo

Single-repo is the most common setup. One project, one repository. Each workspace gets a worktree of that repo.

Multi-repo is for projects that span multiple repositories — a frontend and a backend, a service and its shared library, a monorepo with multiple deployable packages. Tracigo groups them under one project so your workspaces span all repos at once.

You don't configure this — Tracigo detects it based on how many repos are in your project folder.

Invited to a project?

When a teammate invites you to their project, you'll see it in your project list. But you won't have the code locally yet.

Click the project, and Tracigo will prompt you to set up locally — choose a folder on your machine, and Tracigo clones the repositories for you. Once set up, you can create and open workspaces just like the project owner.

Contributors

Projects have two roles:

  • Owner — the person who created the project. Can invite and remove contributors, delete the project.
  • Contributor — invited team members. Can create workspaces, edit artifacts, and collaborate on shared artifacts.

To invite someone, go to the project page and click Invite. They'll need a Tracigo account with the same email you invite.

Project settings

The project Settings tab has three sections:

Monitored Commands

Add project-specific terminal commands to monitor (e.g., cdk deploy, nx build). Default commands like npm, yarn, cargo, docker are always active. See Terminals for more.

Agent Instructions

Toggle whether Tracigo generates instruction files for AI agents, and select which agents to configure. See Agent Integration for the full guide.

Danger Zone

Project owners can permanently delete a project. This removes all workspaces, artifacts, and history for every contributor.

What lives where

your-project-folder/
├── main-repo/              ← your original clone (untouched by Tracigo)
├── feature-auth/           ← workspace worktree (created by Tracigo)
├── fix-checkout-bug/       ← another workspace worktree
└── ...

Tracigo never modifies your original repository clones. All workspace activity happens in separate worktrees that Tracigo creates and manages.