Skip to main content

Quick start

The fastest way to get started is to let the Mayor coordinate everything.

gt install ~/gt --git
cd ~/gt
gt config agent list
gt mayor attach

Tell the Mayor what you want to build and it will:

  1. Analyze the work and break it into tasks.
  2. Create convoys and assign beads.
  3. Spawn or sling polecats to handle the work.
  4. Track progress until completion.

Example: feature development

# 1. Start the Mayor
gt mayor attach

# 2. In the Mayor session, create a convoy with bead IDs
gt convoy create "Feature X" gt-abc12 gt-def34 --notify --human

# 3. Assign work to an agent
gt sling gt-abc12 myproject

# 4. Track progress
gt convoy list