Overview

Complete reference for all Locus CLI commands.

Usage

locus <command> [options]

---

Commands

Command	Description
init	Initialize Locus in the current directory
config	Manage settings (API key, provider, model)
run	Start agents to work on sprint tasks
plan	Run AI sprint planning meeting
exec	Execute a prompt with repository context
review	AI code review for PRs and staged changes
agents	Manage agent worktrees
docs	Sync workspace documents
index	Index the codebase for AI context
telegram	Configure the Telegram bot

---

Global Options

Option	Description
--help	Show help message
--provider <name>	AI provider: claude or codex (default: claude)

---

Getting Started

# Initialize and configure
locus init
locus config setup

# Start working
locus run

# Or plan first
locus plan "your goal"

---

Common Workflows

Execute sprint tasks

locus run --agents 3

One-off AI execution

locus exec "add error handling to the login endpoint"

Review pull requests

locus review

Interactive session

locus exec -i