Skip to content

Get Started

ben-ic edited this page Mar 15, 2026 · 5 revisions

Get Started in 2 Minutes

The shortest path from an empty repo to a working, synced team.

Shortest possible version: Run npx @teamrc/cli init. If the generated team looks good, you are already done. The rest of this page is for editing, syncing, or sharing it.

1. Create a team

Start in your project directory:

npx @teamrc/cli init

This creates the team on the relay, generates your machine keypair, writes .teamrc.yaml, and applies the generated platform files locally.

You'll pick a template (e.g. fullstack, backend, security) and your platforms (e.g. claude-code, cursor). The team is live immediately.

2. Open the web UI if you want to tweak the team

Open the current team directly from the CLI. No account is required.

npx @teamrc/cli dashboard

This opens your team in the browser and prints the URL as a fallback. From there you can add members, assign skills, or edit instructions.

3. Pull the latest version back to your machine

After editing in the browser, sync locally:

npx @teamrc/cli sync

That fetches the latest team definition from the relay and regenerates platform-native files.

4. Connect another machine or project

On the first machine, create an invite:

npx @teamrc/cli invite

Then on the second machine (or in another repo that should use the same team):

npx @teamrc/cli join trc_inv_...

That machine becomes part of the same sync loop and will receive future updates.

5. Fork someone else's team

If someone shared their team config publicly, you can clone it and make it your own:

npx @teamrc/cli clone trc_cl_...   # copy their config locally
# edit .teamrc.yaml if you want to customize
npx @teamrc/cli init                # creates your own team on the relay

init detects the cloned .teamrc.yaml, adopts it, and creates a new independent team. You get full ownership. The original team is not affected.

What just happened

  • .teamrc.yaml is your team definition. Commit it.
  • .claude/agents/trc-*.md (or the equivalent for your platform) are the generated files your AI assistant reads. These are gitignored.
  • The relay at teamrc.ai stores the canonical team state and handles sync.
  • Each machine has its own Ed25519 keypair at ~/.teamrc/key. No account needed.

Next steps

Clone this wiki locally