@locusai/cli 0.21.0 → 0.21.1

package/README.md

@@ -0,0 +1,194 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/asgarovf/locusai/master/assets/logo.png" alt="Locus" width="200" />
+</p>
+
+<h3 align="center">GitHub-native AI engineering CLI</h3>
+
+<p align="center">
+  Turn GitHub issues into shipped code — plan sprints, execute tasks with AI agents, and iterate on feedback.
+</p>
+
+<p align="center">
+  <a href="https://github.com/asgarovf/locusai/stargazers"><img src="https://img.shields.io/github/stars/asgarovf/locusai?style=flat&color=blue" alt="GitHub Stars" /></a>
+  <a href="https://www.npmjs.com/package/@locusai/cli"><img src="https://img.shields.io/npm/v/@locusai/cli?label=%40locusai%2Fcli&color=blue" alt="@locusai/cli" /></a>
+  <a href="https://github.com/asgarovf/locusai/blob/master/LICENSE"><img src="https://img.shields.io/github/license/asgarovf/locusai?style=flat&color=blue" alt="License" /></a>
+  <a href="https://docs.locusai.dev"><img src="https://img.shields.io/badge/docs-locusai.dev-blue" alt="Documentation" /></a>
+</p>
+
+<p align="center">
+  <a href="https://docs.locusai.dev">Documentation</a> &middot; <a href="https://docs.locusai.dev/getting-started/quickstart">Quick Start</a> &middot; <a href="https://github.com/asgarovf/locusai">GitHub</a> &middot; <a href="https://github.com/asgarovf/locusai/issues">Issues</a>
+</p>
+
+---
+
+> GitHub Issues are tasks. Milestones are sprints. Labels track status. Pull Requests are deliverables. **No servers. No database. No accounts.**
+
+## Prerequisites
+
+- [Node.js](https://nodejs.org) 18+
+- [GitHub CLI](https://cli.github.com) (`gh`) — authenticated via `gh auth login`
+- An AI provider CLI: [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview) or [Codex](https://openai.com/index/introducing-codex/)
+- [Docker Desktop](https://www.docker.com/products/docker-desktop/) 4.58+ for sandboxed execution (optional)
+
+## Install
+
+```bash
+npm install -g @locusai/cli
+```
+
+## Quick Start
+
+```bash
+# Initialize in your GitHub repo
+locus init
+
+# Plan a sprint from a goal
+locus plan "Build user authentication with OAuth"
+
+# Execute the sprint — agents write code, push commits, open PRs
+locus run
+
+# Review the PRs with AI
+locus review
+
+# Agents address feedback and update the PRs
+locus iterate
+```
+
+## How It Works
+
+```
+locus plan "your goal"    →  AI breaks the goal into GitHub Issues with execution order
+locus run                 →  Agents execute tasks sequentially, push code, create PRs
+locus review              →  AI reviews PRs, posts inline comments on GitHub
+locus iterate             →  Agents address review feedback until ready to merge
+```
+
+**GitHub IS the backend:**
+
+| Concept | GitHub Primitive |
+|---------|-----------------|
+| Task | Issue |
+| Sprint | Milestone |
+| Status | Labels (`locus:queued`, `locus:in-progress`, `locus:done`, `locus:failed`) |
+| Priority | Labels (`p:critical`, `p:high`, `p:medium`, `p:low`) |
+| Execution Order | Labels (`order:1`, `order:2`, ...) |
+| Deliverable | Pull Request |
+
+## CLI Reference
+
+### Setup & Configuration
+
+| Command | Description |
+|---------|-------------|
+| `locus init` | Initialize project with `.locus/` structure and GitHub labels |
+| `locus config` | View and manage settings |
+| `locus upgrade` | Self-upgrade to latest version |
+
+### Work Modeling
+
+| 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 plan` | | AI-powered sprint planning from a goal description |
+
+### Execution & Review
+
+| Command | Alias | Description |
+|---------|-------|-------------|
+| `locus run` | | Execute sprint tasks or standalone issues with AI agents |
+| `locus exec` | `locus e` | Interactive REPL or one-shot prompt execution |
+| `locus review` | | AI code review on pull requests |
+| `locus iterate` | | Re-execute tasks with PR feedback context |
+| `locus discuss` | | AI-powered architectural discussions |
+
+### Visibility
+
+| Command | Description |
+|---------|-------------|
+| `locus status` | Dashboard view of project state |
+| `locus logs` | View, tail, and manage execution logs |
+| `locus artifacts` | View and manage AI-generated artifacts |
+
+### Packages
+
+| Command | Description |
+|---------|-------------|
+| `locus install` | Install a community package from npm |
+| `locus uninstall` | Remove an installed package |
+| `locus packages` | List installed packages |
+| `locus pkg <name>` | Run a package-provided command |
+
+### Sandbox Management
+
+| Command | Description |
+|---------|-------------|
+| `locus sandbox` | Create provider sandboxes and enable sandbox mode |
+| `locus sandbox claude` | Authenticate Claude inside its sandbox |
+| `locus sandbox codex` | Authenticate Codex inside its sandbox |
+| `locus sandbox install <pkg>` | Install global npm package(s) in provider sandbox(s) |
+| `locus sandbox shell <provider>` | Open an interactive shell in a provider sandbox |
+| `locus sandbox logs <provider>` | Show provider sandbox logs |
+| `locus sandbox rm` | Destroy provider sandboxes and disable sandbox mode |
+| `locus sandbox status` | Show current sandbox state |
+
+## Workflows
+
+### Sprint: plan, execute, review, iterate
+
+```bash
+locus plan "Add SSO login and role-based access"
+locus run
+locus review
+locus iterate --sprint
+```
+
+### Parallel standalone issues
+
+```bash
+# Run 3 independent issues concurrently
+locus run 42 43 44
+```
+
+### Resume a failed run
+
+```bash
+# Pick up where it left off — completed tasks are skipped
+locus run --resume
+```
+
+### Interactive coding session
+
+```bash
+# Start a REPL session
+locus exec
+
+# Or one-shot
+locus exec "Refactor the auth middleware to use JWT"
+```
+
+## Key Flags
+
+| Flag | Description |
+|------|-------------|
+| `-d, --debug` | Debug logging |
+| `-h, --help` | Show help |
+| `-V, --version` | Show version |
+| `--dry-run` | Simulate without executing |
+| `--model <name>` | Override AI model |
+| `--resume` | Resume interrupted runs |
+| `--no-sandbox` | Disable Docker isolation |
+| `--sandbox=require` | Require Docker (fail if unavailable) |
+
+## VS Code Extension
+
+Locus includes a [VS Code extension](https://marketplace.visualstudio.com/items?itemName=locusai.locus) with an integrated chat interface for running tasks directly from your editor.
+
+## Documentation
+
+Full documentation is available at [docs.locusai.dev](https://docs.locusai.dev).
+
+## License
+
+[MIT](https://github.com/asgarovf/locusai/blob/master/LICENSE)

package/bin/locus.js

@@ -34,7 +34,7 @@ function inferProviderFromModel(model) {
     return "codex";
   return;
 }
-var CLAUDE_MODELS, CODEX_MODELS, CLAUDE_MODEL_SET, CODEX_MODEL_SET, ALL_MODEL_SET;
+var CLAUDE_MODELS, CODEX_MODELS, CLAUDE_MODEL_SET, CODEX_MODEL_SET;
 var init_ai_models = __esm(() => {
   CLAUDE_MODELS = [
     "opus",
@@ -59,7 +59,6 @@ var init_ai_models = __esm(() => {
   ];
   CLAUDE_MODEL_SET = new Set(CLAUDE_MODELS);
   CODEX_MODEL_SET = new Set(CODEX_MODELS);
-  ALL_MODEL_SET = new Set([...CLAUDE_MODELS, ...CODEX_MODELS]);
 });
 
 // src/core/config.ts
@@ -280,13 +279,12 @@ function drawBox(lines, options) {
   return parts.join(`
 `);
 }
-var cachedCapabilities = null, enabled = () => getCapabilities().colorBasic, bold, dim, italic, underline, strikethrough, red, green, yellow, blue, magenta, cyan, white, gray, redBright, greenBright, yellowBright, blueBright, magentaBright, cyanBright, bgRed, bgGreen, bgYellow, bgBlue, bgGray, box;
+var cachedCapabilities = null, enabled = () => getCapabilities().colorBasic, bold, dim, italic, underline, red, green, yellow, blue, magenta, cyan, white, gray, box;
 var init_terminal = __esm(() => {
   bold = wrap("\x1B[1m", "\x1B[22m");
   dim = wrap("\x1B[2m", "\x1B[22m");
   italic = wrap("\x1B[3m", "\x1B[23m");
   underline = wrap("\x1B[4m", "\x1B[24m");
-  strikethrough = wrap("\x1B[9m", "\x1B[29m");
   red = wrap("\x1B[31m", "\x1B[39m");
   green = wrap("\x1B[32m", "\x1B[39m");
   yellow = wrap("\x1B[33m", "\x1B[39m");
@@ -295,17 +293,6 @@ var init_terminal = __esm(() => {
   cyan = wrap("\x1B[36m", "\x1B[39m");
   white = wrap("\x1B[37m", "\x1B[39m");
   gray = wrap("\x1B[90m", "\x1B[39m");
-  redBright = wrap("\x1B[91m", "\x1B[39m");
-  greenBright = wrap("\x1B[92m", "\x1B[39m");
-  yellowBright = wrap("\x1B[93m", "\x1B[39m");
-  blueBright = wrap("\x1B[94m", "\x1B[39m");
-  magentaBright = wrap("\x1B[95m", "\x1B[39m");
-  cyanBright = wrap("\x1B[96m", "\x1B[39m");
-  bgRed = wrap("\x1B[41m", "\x1B[49m");
-  bgGreen = wrap("\x1B[42m", "\x1B[49m");
-  bgYellow = wrap("\x1B[43m", "\x1B[49m");
-  bgBlue = wrap("\x1B[44m", "\x1B[49m");
-  bgGray = wrap("\x1B[100m", "\x1B[49m");
   box = {
     topLeft: "┌",
     topRight: "┐",
@@ -783,12 +770,17 @@ var exports_progress = {};
 __export(exports_progress, {
   renderTaskStatus: () => renderTaskStatus,
   progressBar: () => progressBar,
-  formatDuration: () => formatDuration,
   createTimer: () => createTimer,
   Spinner: () => Spinner
 });
 function progressBar(current, total, options = {}) {
-  const { width = 30, showPercent = true, showCount = true, label } = options;
+  const {
+    width = 30,
+    showPercent = true,
+    showCount = true,
+    brackets = true,
+    label
+  } = options;
   const percent = total > 0 ? current / total : 0;
   const filled = Math.round(width * percent);
   const empty = width - filled;
@@ -796,7 +788,7 @@ function progressBar(current, total, options = {}) {
   const parts = [];
   if (label)
     parts.push(label);
-  parts.push(`[${bar}]`);
+  parts.push(brackets ? `[${bar}]` : bar);
   if (showPercent)
     parts.push(bold(`${Math.round(percent * 100)}%`));
   if (showCount)
@@ -6407,8 +6399,12 @@ async function sprintList(projectRoot, parsed) {
         const total = open + closed;
         if (total === 0)
           return dim("no issues");
-        const pct = Math.round(closed / total * 100);
-        const bar = progressBar2(pct, 10);
+        const bar = progressBar(closed, total, {
+          width: 10,
+          brackets: false,
+          showPercent: false,
+          showCount: false
+        });
         return `${bar} ${dim(`${closed}/${total}`)}`;
       }
     },
@@ -6501,7 +6497,7 @@ ${bold(`Sprint: ${milestone.title}`)} ${dim(`(${milestone.state})`)}
   const details = renderDetails([
     {
       label: "Progress",
-      value: `${progressBar2(pct, 20)} ${bold(`${pct}%`)} ${dim(`(${milestone.closedIssues}/${total} tasks)`)}`
+      value: `${progressBar(milestone.closedIssues, total, { width: 20, brackets: false, showPercent: false, showCount: false })} ${bold(`${pct}%`)} ${dim(`(${milestone.closedIssues}/${total} tasks)`)}`
     },
     {
       label: "Due",
@@ -6847,11 +6843,6 @@ function formatStatus2(labels) {
   }
   return dim("—");
 }
-function progressBar2(percent, width) {
-  const filled = Math.round(percent / 100 * width);
-  const empty = width - filled;
-  return green("█".repeat(filled)) + dim("░".repeat(empty));
-}
 function printSprintHelp() {
   process.stderr.write(`
 ${bold("locus sprint")} — Manage sprints via GitHub Milestones
@@ -6889,6 +6880,7 @@ var init_sprint = __esm(() => {
   init_config();
   init_github();
   init_logger();
+  init_progress();
   init_table();
   init_terminal();
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@locusai/cli",
-  "version": "0.21.0",
+  "version": "0.21.1",
   "description": "GitHub-native AI engineering assistant",
   "type": "module",
   "bin": {