CLI

The crewkit CLI manages your AI coding sessions, team configuration, and project setup from the terminal.

crewkit              # Start a coding session — Claude Code runs here, crewkit observing
crewkit code         # Start a coding session
crewkit auth login   # Connect to your account

Bare crewkit is the same as crewkit code — every launch flag works bare (crewkit -c, crewkit -p "...", crewkit --sensitive). A flagless crewkit with piped or captured output shows the setup overview instead, which also lives at crewkit status.

Commands

crewkit code

Start a coding session with your team's agents.

crewkit code                          # Native Claude Code, crewkit alongside
crewkit tui                           # The same session in crewkit's terminal interface
crewkit code --prompt "Fix the bug"   # Headless one-shot
crewkit code -c                       # Continue most recent session
crewkit code --resume                 # Pick a session to resume
crewkit code --resume <id>            # Resume specific session

By default on macOS and Linux, crewkit code launches the native claude — Claude Code owns the terminal exactly as if you'd run it directly — while crewkit loads beside it in the background: session tracking, telemetry, and team context. crewkit adds a statusline to the Claude Code session on every observed launch (opt out with --no-statusline, CREWKIT_STATUSLINE=off, or [statusline] enabled = false in .crewkit/config.toml). If the background observer cannot be set up, the launch fails with the reason rather than silently starting an unobserved session — run crewkit tui if you want the interactive terminal interface. On Windows, the interactive terminal interface remains the default.

Flags:

Flag	Description
`--debug`	Enable debug logging (per-session log at `.crewkit/debug-latest.log`)
`-v, --verbose`	Show detailed output (file lists, timing)
`-p, --prompt <text>`	Run headless with a prompt
`--output-format <fmt>`	Output format: `text`, `json`, `stream-json` (requires `--prompt`)
`--timeout <secs>`	Max execution time for headless mode (default: 300)
`-q, --quiet`	Suppress progress output in headless mode
`-c, --continue-session`	Continue most recent Claude session
`-r, --resume [id]`	Resume a session by ID, or show picker
`--fork-session`	Fork the resumed session (new ID, existing context)
`--sensitive`	Mark session as sensitive (excluded from cross-repo discovery)
`--repo-id <id>`	Explicit repository ID (also: `CREWKIT_REPOSITORY_ID` env var)
`-y, --yes`	Skip interactive prompts (for CI/CD)
`--no-auth`	Skip authentication (sessions will not be tracked)
`--no-statusline`	Don't add the crewkit statusline to the Claude Code session
`--status`	Show the background observers for this directory (same as `crewkit sidecar status`)
`--stop`	Stop this terminal's background observer (same as `crewkit sidecar stop`; `--all` stops every observer for the directory)
`--no-artifacts`	Disable artifact context injection into the session
`--no-context`	Skip injecting save-state recall context (personal + team digests)
`--no-title`	Disable terminal window title
`--disable-lsp`	Disable LSP server auto-start
`--chrome`	Use Chrome for browser automation
`--llm-gateway`	Enable LLM gateway proxy
`--llm-gateway-port <port>`	Gateway proxy port (default: ephemeral)
`--dangerously-skip-permissions`	Skip all permission prompts (CI/CD only — disables safety checks)

--no-tui is deprecated: it named the old opt-out, and its behavior — native Claude Code with crewkit alongside — is now the default. --tui likewise still parses, but the documented spelling is crewkit tui.

crewkit tui

Start the same coding session inside crewkit's interactive terminal interface — a live sidebar with session metrics, git context, and AI summaries.

crewkit tui                           # Coding session with the live sidebar
crewkit tui -c                        # Session launch flags work here too

crewkit tui takes the session launch flags (-c/--continue-session, --resume, --sensitive, ...) but not headless -p — headless is crewkit -p "...". On Windows, this interface is the default under every spelling.

crewkit sidecar

An alias of crewkit code — the same launch under a second name. Its status and stop subcommands inspect or stop the background observers that ship with the default launch (macOS and Linux).

crewkit sidecar                       # Launch claude with a background observer
crewkit sidecar status                # Show observer state for this project
crewkit sidecar status --json         # Machine-readable state
crewkit sidecar stop                  # Stop the observer in this terminal
crewkit sidecar stop --all            # Stop every observer for this directory

Note: crewkit sidecar status reports the background observers, while crewkit status shows the setup overview.

crewkit init

Pin a single-repository mapping locally, or create a multi-repository workspace.

crewkit init                # Pin the detected mapping in .agent/config.yml
crewkit init --yes          # The same prompt-free local pin for a single repo
crewkit init --workspace    # Create and register a workspace project

Single-repository init does not create a project on the server. Use crewkit project create for registration; --yes does not change that boundary. Workspace init still creates the workspace project server-side.

crewkit auth

Manage authentication.

crewkit auth login    # Log in via device flow
crewkit auth logout   # Log out and clear tokens
crewkit auth status   # Show current auth status

crewkit org

Organization management.

crewkit org info                    # Show current org info
crewkit org info --org acme         # Show specific org
crewkit org update --name "Acme"    # Update org name
crewkit org delete --org acme       # Delete org (requires --force)

crewkit project

Project management.

crewkit project list                                  # List projects
crewkit project create "My Project" --org acme       # Register without prompts
crewkit project info                                  # Show current project

crewkit project create <NAME> [--org <SLUG_OR_ID>] registers a repository project server-side without onboarding or device-flow prompts. Use an explicit organization slug or external ID for deterministic CI and BYOC setup. Inside a git repository, crewkit includes the detected origin remote; outside git, creation still works when --org is supplied. This command does not write local configuration.

crewkit members

Team member management.

crewkit members list                           # List members
crewkit members invite user@example.com        # Invite (default: member role)
crewkit members invite user@example.com -r admin  # Invite as admin
crewkit members update user@example.com -r admin  # Change role
crewkit members remove user@example.com        # Remove member
crewkit members invitations                    # List pending invitations

crewkit resources

View and manage resources (agents, skills, commands, rules).

crewkit resources list                        # List all resources
crewkit resources list --type agent            # Filter by type
crewkit resources show rails-expert            # Show resource details
crewkit resources inspect rails-expert         # Inspect full config
crewkit resources import                      # Import local resources
crewkit resources import --dry-run             # Preview import

crewkit playbooks

Preview applicable playbooks.

crewkit playbooks list              # List playbooks
crewkit playbooks list --detail     # Show convention details
crewkit playbooks show <id>         # Show specific playbook

crewkit sessions

Browse, inspect, share, and report on sessions.

crewkit sessions list                            # Recent sessions (current project)
crewkit sessions list --all-projects             # Across the whole organization
crewkit sessions list --since 7d --user me       # Your sessions from the last week
crewkit sessions show <id>                       # Full detail (accepts short id prefix)
crewkit sessions report --week                   # Team digest: sessions, cost, top agents

Share a session — create, list, or revoke share links:

crewkit sessions share <id>                      # Org-visible link, expires in 7 days
crewkit sessions share <id> --access public      # Anyone with the link (requires admin)
crewkit sessions share <id> --level summary      # Levels: summary, transcript, full
crewkit sessions share <id> --expires 0          # Never expires
crewkit sessions share <id> --list               # List existing shares
crewkit sessions share <id> --revoke <share-id>  # Revoke a share

Import history — bring in local Claude Code JSONL transcripts:

crewkit sessions import                          # Import local Claude conversations
crewkit sessions import --since 2026-01-01       # Import recent only
crewkit sessions import --dry-run                # Preview what would import
crewkit sessions import <transcript-id>          # Import specific conversation

Most subcommands accept --json for piping.

crewkit blueprint

AI-powered project planning with epics and tasks.

crewkit blueprint create "Ship the billing revamp"  # Generate a blueprint from a goal
crewkit blueprint list                              # List blueprints for this project
crewkit blueprint show <id>                         # Epics and tasks
crewkit blueprint review                            # Review against the local codebase
crewkit blueprint tasks --status pending            # List tasks, filter by status
crewkit blueprint start <task-id>                   # Claim a task (sets in_progress)
crewkit blueprint complete <task-id>                # Mark a task completed
crewkit blueprint export                            # Export as a plan file to .claude/work/

crewkit save-state

Manage project save states (personal handoffs + team digests).

crewkit save-state ls               # List this project's save states
crewkit save-state show personal    # Show your handoff
crewkit save-state show team        # Show the most recent team digest
crewkit save-state rm <id>          # Delete a save state

crewkit lsp

Code intelligence server for Claude Code.

crewkit lsp install            # Install plugin (user-wide)
crewkit lsp install --project  # Install for current project
crewkit lsp uninstall          # Remove plugin
crewkit lsp status             # Check installation
crewkit lsp start              # Start LSP server (usually auto-started)

crewkit mcp

MCP server exposing crewkit's project memory to agents. Any MCP-capable agent can pull project context, conventions, prior work, active work, and blueprint state. Sessions launched by crewkit code register it automatically.

crewkit mcp serve                     # Start the stdio MCP server
crewkit mcp serve --org <id>          # Override organization detection
crewkit mcp serve --project <id>      # Override project detection

Utility commands

crewkit status                   # Setup overview (auth, project, sync state)
crewkit status --json            # Machine-readable overview
crewkit whoami                   # Show current user
crewkit update                   # Update crewkit
crewkit update --check           # Check for updates
crewkit feedback "message"       # Send feedback
crewkit completions zsh          # Generate shell completions (bash, zsh, fish, ...)

Global flags

Flag	Description
`--no-color`	Disable colors (also respects `NO_COLOR` env var)
`--plain`	ASCII-only output (no unicode symbols)
`--debug`	Enable debug logging (per-session log at `.crewkit/debug-latest.log`)
`--version`	Show version
`--help`	Show help