@dendroman/sidecar-cli

Sidecar CLI - Agentic Project Tracking with Git worktree and MCP.

Installation

npm install -g @dendroman/sidecar-cli

Or use with npx:

npx @dendroman/sidecar-cli init

Usage

Initialize a Sidecar project

sidecar init

This creates:

• A agent-data orphan branch for storing project data
• A .sidecar/ worktree directory with:
  • backlog.json - Task backlog and swimlane data
  • active_agents.json - Active agent tracking
  • specs/ - Agent specification files

Check project status

sidecar status

Shows:

• Tasks by swimlane (backlog, sprint, done)
• Active agents and their current tasks
• Recent activity

Start the MCP server

sidecar serve

Starts the Model Context Protocol server for AI agent integration.

Launch the dashboard

sidecar dashboard

Launches the web dashboard pointed at the current repository.

# Launch dashboard for a specific repo
sidecar dashboard /path/to/repo

# Use a specific port
sidecar dashboard --port 3002

Commands

| Command | Description | |---------|-------------| | init | Initialize Sidecar in current directory | | status | Show project status | | serve | Start MCP server | | dashboard [path] | Launch web dashboard |

MCP Tools

The MCP server provides these tools for AI agents:

• get_context - Get full project context
• claim_task - Claim a task from the backlog
• complete_task - Mark a task as complete
• heartbeat - Send agent heartbeat

License

ISC