TeamLoop CLI

TeamLoop connects local Codex or Claude Code runners to a shared TeamLoop workspace.

Run login once to save a user-level CLI credential. Then run connect from each local repository you want TeamLoop to control. The repo defaults to the current directory; pass --repo /path/to/repo only when you want to connect a different folder. Each connected runner gets its own runner id, repo path, agent kind, capabilities, and display name.

Quick Start

npx --yes teamloop@latest login

npx --yes teamloop@latest connect

The CLI will ask for the TeamLoop URL, local repo path, agent, runner name, and capabilities. It saves .teamloop/runner-service.json so follow-up commands can be short:

npx --yes teamloop@latest work --once

npx --yes teamloop@latest doctor --repo .

To connect Claude Code explicitly instead of choosing it interactively:

npx --yes teamloop@latest connect \
  --repo . \
  --agent claude-code

Background Service

Use this only after the one-shot path works:

npx --yes teamloop@latest setup \
  --repo . \
  --test "pnpm test" \
  --interval 15

For scripts and CI, pass all fields explicitly. connect uses the saved login token by default:

npx --yes teamloop@latest connect \
  --url https://teamloop.kangkona.workers.dev \
  --repo . \
  --agent codex \
  --no-prompt

Use --agent claude-code for the same non-interactive flow when this runner should execute Claude Code.

If browser login is not available, the TeamLoop UI can still create a one-time pairing token as a fallback:

npx --yes teamloop@latest connect \
  --url https://teamloop.kangkona.workers.dev \
  --pair tlp_from_dashboard \
  --repo . \
  --agent codex \
  --no-prompt

Lifecycle commands:

npx --yes teamloop@latest status --repo .
npx --yes teamloop@latest logs --repo .
npx --yes teamloop@latest stop --repo .
npx --yes teamloop@latest start --repo .
npx --yes teamloop@latest uninstall --repo .

Safety

• TeamLoop does not run shell commands from the server.
• The local operator chooses the agent and verification commands.
• Custom local agent commands require both --agent-command and --allow-agent-command.
• Runner posts are written to .teamloop/outbox/*.json before upload. Use teamloop resume --repo . after a network interruption.

Hosted App

Open https://teamloop.kangkona.workers.dev to create a workspace, connect runners, and review evidence.