@locusai/cli 0.25.0 → 0.25.1

package/README.md

@@ -90,7 +90,7 @@ locus iterate             →  Agents address review feedback until ready to mer
 | Command | Alias | Description |
 |---------|-------|-------------|
 | `locus issue` | `locus i` | Create, list, show, label, and close GitHub issues |
-| `locus sprint` | `locus s` | Create, list, show, activate, reorder, and close sprints |
+| `locus sprint` | `locus s` | Create, list, show, reorder, and close sprints |
 | `locus plan` | | AI-powered sprint planning from a goal description |
 
 ### Execution & Review
@@ -102,6 +102,7 @@ locus iterate             →  Agents address review feedback until ready to mer
 | `locus review` | | AI code review on pull requests |
 | `locus iterate` | | Re-execute tasks with PR feedback context |
 | `locus discuss` | | AI-powered architectural discussions |
+| `locus commit` | | AI-powered commit message generation |
 
 ### Visibility
 
@@ -111,14 +112,27 @@ locus iterate             →  Agents address review feedback until ready to mer
 | `locus logs` | View, tail, and manage execution logs |
 | `locus artifacts` | View and manage AI-generated artifacts |
 
+### Skills
+
+| Command | Description |
+|---------|-------------|
+| `locus skills` | List available agent skills |
+| `locus skills list` | List remote skills from the registry |
+| `locus skills list --installed` | List locally installed skills |
+| `locus skills install <name>` | Install a skill from the registry |
+| `locus skills remove <name>` | Uninstall a skill |
+| `locus skills update [name]` | Update all or a specific skill |
+| `locus skills info <name>` | Show skill details |
+
 ### Packages
 
 | Command | Description |
 |---------|-------------|
-| `locus install` | Install a community package from npm |
-| `locus uninstall` | Remove an installed package |
+| `locus install <name>` | Install a community package from npm |
+| `locus uninstall <name>` | Remove an installed package |
 | `locus packages` | List installed packages |
-| `locus pkg <name>` | Run a package-provided command |
+| `locus pkg <name> [cmd]` | Run a package-provided command |
+| `locus create <name>` | Scaffold a new community package |
 
 ### Sandbox Management
 
@@ -133,6 +147,75 @@ locus iterate             →  Agents address review feedback until ready to mer
 | `locus sandbox rm` | Destroy provider sandboxes and disable sandbox mode |
 | `locus sandbox status` | Show current sandbox state |
 
+## Command Details
+
+### `locus plan`
+
+AI-powered sprint planning with plan management:
+
+```bash
+locus plan "Build OAuth login"              # Generate a plan from a goal
+locus plan --sprint "v1.0"                  # Assign planned issues to a sprint
+locus plan --from-issues --sprint "v1.0"    # Organize existing issues into a plan
+locus plan approve <id> <sprintname>        # Create GitHub issues from a plan
+locus plan refine <id> "add rate limiting"  # Refine an existing plan with feedback
+locus plan list                             # List saved plans
+locus plan show <id>                        # Display a saved plan
+locus plan --dry-run                        # Preview without creating issues
+```
+
+### `locus run`
+
+Execute sprint tasks or standalone issues with AI agents:
+
+```bash
+locus run                        # Run all open sprints (parallel)
+locus run --sprint "v1.0"        # Run a specific sprint
+locus run 42                     # Run a single issue (in worktree)
+locus run 42 43 44               # Run multiple issues in parallel
+locus run --resume               # Resume an interrupted run
+locus run --dry-run              # Preview what would execute
+locus run --model claude         # Override AI model
+locus run --no-sandbox           # Run without Docker isolation
+locus run --sandbox=require      # Fail if Docker sandbox is unavailable
+```
+
+### `locus exec`
+
+Interactive REPL or one-shot prompt execution:
+
+```bash
+locus exec                          # Start interactive REPL
+locus exec "Add error handling"     # One-shot prompt
+locus exec -s <session-id>          # Resume a previous session
+locus exec sessions list            # List saved sessions
+locus exec sessions show <id>       # Show session details
+locus exec sessions delete <id>     # Delete a session
+locus exec --json-stream            # NDJSON output for IDE integration
+```
+
+### `locus commit`
+
+AI-powered commit message generation from staged changes:
+
+```bash
+locus commit                # Generate and commit
+locus commit --dry-run      # Preview message without committing
+locus commit --model <name> # Override AI model
+```
+
+### `locus skills`
+
+Discover and install agent skills from a centralized registry:
+
+```bash
+locus skills                      # List available skills
+locus skills install <name>       # Install a skill
+locus skills remove <name>        # Uninstall a skill
+locus skills update               # Update all installed skills
+locus skills info <name>          # Show skill details
+```
+
 ## Workflows
 
 ### Sprint: plan, execute, review, iterate
@@ -178,8 +261,12 @@ locus exec "Refactor the auth middleware to use JWT"
 | `--dry-run` | Simulate without executing |
 | `--model <name>` | Override AI model |
 | `--resume` | Resume interrupted runs |
+| `--sprint <name>` | Target a specific sprint |
+| `--from-issues` | Use existing issues for planning |
 | `--no-sandbox` | Disable Docker isolation |
 | `--sandbox=require` | Require Docker (fail if unavailable) |
+| `--json-stream` | NDJSON output for IDE integration |
+| `-s, --session-id <id>` | Resume a REPL session |
 
 ## Documentation
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@locusai/cli",
-  "version": "0.25.0",
+  "version": "0.25.1",
   "description": "GitHub-native AI engineering assistant",
   "type": "module",
   "bin": {
@@ -36,7 +36,7 @@
   "license": "MIT",
   "dependencies": {},
   "devDependencies": {
-    "@locusai/sdk": "^0.25.0",
+    "@locusai/sdk": "^0.25.1",
     "@types/bun": "latest",
     "typescript": "^5.8.3"
   },