CLI Commands Reference

The teamctx CLI is the primary interface for TeamContext. It handles setup, team queries, handoffs, plans, and runs the MCP server for AI tool integration.

Most commands support --json for machine-readable output.

Configure your API key and connect to your TeamContext team. Run this once before using any other command.

Interactive prompts:

• API URL — Default: https://api.teamcontext.ai
• API Key — Your key from Settings → API Keys (masked input)

Validates the key via /auth/me, then saves config to ~/.teamctx/config.json.

Install hooks for your AI coding tools. Auto-detects installed tools and prompts for selection.

Options:

• --claude-code — Install Claude Code hooks only
• --codex-cli — Install Codex CLI hooks only
• --gemini-cli — Install Gemini CLI hooks only
• --all — Install all detected tools
• --git-hook — Install git post-commit hook only

Example:

Diagnose setup issues. Checks Node version, config, API connectivity, git hooks, AI tools, and MCP server configuration.

Outputs a table showing each AI tool's detection and hook status, with remedial suggestions for any failures.

Show your team members' current status — who's online, what branch they're on, and what they're working on.

Output columns: Name • Branch • Working On • Last Active • Online Status

Show recent team activity across all coding sessions.

Options:

• --author <name> — Filter by team member name
• --since <duration> — Time filter (e.g. 2h, 1d, 30m)
• --path <glob> — Filter by file path pattern
• --limit <n> — Number of results (default: 20)
• --source <source> — Filter by source (git-hook, claude-code-cli, codex-cli, gemini-cli)
• --json — Output as JSON

Example:

Show who's currently working, with optional file details.

Options:

• --files — Show files each member touched today, grouped by directory
• --json — Output as JSON

Output columns: Name • Branch • Working On • Project • Turns Today • Last Activity

Show the latest AI-generated daily or weekly summary of your team's activity.

Great for morning check-ins — see what your team accomplished while you were away.

Check if anyone on your team is working on overlapping files or systems.

Shows active conflicts with the members involved and overlapping files.

Show a comprehensive snapshot of your team's current state. Combines multiple views into one output.

Includes:

• Who's currently working (members, branches, activity)
• Recent technical decisions (5 most recent)
• Active conflicts (overlapping files)
• Open handoffs (pending work)
• Latest team summary

Full-text search across all captured turns and decisions.

Options:

• --type <type> — Filter by type: all, turns, decisions (default: all)
• --limit <n> — Number of results (default: 20)
• --json — Output as JSON

Example:

Start the Model Context Protocol server in stdio mode. This is what AI coding tools connect to for accessing TeamContext tools.

You typically don't run this manually — it's started automatically by your AI tool via the .mcp.json configuration. Exposes 35+ tools for team queries, plans, handoffs, conflicts, and more.

Remove all TeamContext hooks, configuration files, and instruction files from your projects.

Removes:

• Git hooks from all detected repos
• AI tool hooks (Claude Code, Codex CLI, Gemini CLI)
• .mcp.json configuration
• Instruction files (CLAUDE.md, AGENTS.md, GEMINI.md)

Prompts to optionally delete the ~/.teamctx/ directory.