- name
- team-pilot
- description
- Set up and operate TeamPilot from zero on a clean machine. Use when cloning the TeamPilot repository, installing dependencies, starting the multi-agent runtime, driving missions in auto/manual mode, replaying runs in web UI, and troubleshooting first-run issues.
Bootstrap and run TeamPilot end-to-end.
Zero-to-run setup (clean environment)
- Ensure prerequisites:
- git --version - node --version (recommend Node 20+) - npm --version
- Clone repository:
- git clone <TEAM_PILOT_REPO_URL> team-pilot - cd team-pilot
- Install dependencies:
- npm install
- Start service:
- npm run up
- Open web UI:
- http://localhost:3333
If EADDRINUSE appears, stop the process occupying port 3333 or start with another port:
PORT=3334 npm run up- then open
http://localhost:3334
First mission (recommended flow)
- In Mission Control, select a template.
- Set execution mode:
- auto for smoke tests - manual for deterministic demos and controlled outputs
- Fill mission goal and launch.
- Confirm graph starts changing (agent lane → task lane → result lane).
Manual mode operation standard
For each task, update in two steps:
task_started(status=running, progress around20-60)task_done(status=done, progress=100, complete output)
Endpoint:
POST /api/tasks/:taskId/update
Suggested payload fields:
status,progress,output,score,eventType,assignee
Replay workflow
- Switch to Replay mode.
- Load a run with frames > 1.
- Scrub slider to inspect each frame.
- Open node detail to verify input/output at each step.
Minimal API checklist
POST /api/missions(create mission)GET /api/state(live state)POST /api/tasks/:taskId/update(manual updates)GET /api/runs(list traces)GET /api/runs/:missionId(load replay trace)POST /api/missions/:missionId/mode(auto/manual switch)
Troubleshooting
- UI opens but no updates:
- verify server log has no crash - verify WebSocket /ws is connected
- Replay seems flat:
- ensure selected run has frames > 1 - ensure task updates were posted to /api/tasks/:taskId/update
- Mission stuck queued:
- check dependency chain and assignee spelling - in manual mode, ensure leader is sending task updates
Output quality bar (content pipelines)
- PLAN: goal, structure, acceptance criteria
- RESEARCH: sources, extracted facts, citations
- VERIFY: confidence, risks, uncertainty
- BUILD: complete final draft
- DELIVER: publish-ready summary + readiness note