loki-mode 5.49.3 → 5.50.0

package/README.md

@@ -11,7 +11,7 @@
 [![Agent Types](https://img.shields.io/badge/Agent%20Types-41-blue)]()
 [![Benchmarks](https://img.shields.io/badge/Benchmarks-Infrastructure%20Ready-blue)](benchmarks/)
 
-**Current Version: v5.49.3**
+**Current Version: v5.50.0**
 
 **[Autonomi](https://www.autonomi.dev/)** | **[Documentation](https://www.autonomi.dev/docs)** | **[GitHub](https://github.com/asklokesh/loki-mode)**
 
@@ -41,56 +41,67 @@
 
 ## Installation
 
+### npm (Recommended)
+
 ```bash
-git clone https://github.com/asklokesh/loki-mode.git ~/.claude/skills/loki-mode
+npm install -g loki-mode
 ```
 
-That's it. Claude Code auto-discovers skills in `~/.claude/skills/`.
+Installs the `loki` CLI and automatically sets up the skill for Claude Code, Codex CLI, and Gemini CLI.
 
-### Use It
+### Homebrew
 
 ```bash
-claude --dangerously-skip-permissions
-# Then say: "Loki Mode with PRD at ./my-prd.md"
+brew tap asklokesh/tap && brew install loki-mode
 ```
 
-### Update
+Installs the `loki` CLI. To also install the skill for interactive use:
 
 ```bash
-cd ~/.claude/skills/loki-mode && git pull
+loki setup-skill
 ```
 
-### Troubleshooting
+### Quick Start
 
-| Problem | Fix |
-|---------|-----|
-| `SKILL.md` not found | Verify: `ls ~/.claude/skills/loki-mode/SKILL.md` |
-| Claude doesn't recognize "Loki Mode" | Restart Claude Code after cloning |
-| Permission denied on clone | Check SSH keys or use HTTPS URL above |
+```bash
+# CLI mode (works with any provider)
+loki start ./prd.md
+loki start ./prd.md --provider codex
+loki start ./prd.md --provider gemini
 
-### Other Installation Methods
+# Interactive mode (inside your coding agent)
+claude --dangerously-skip-permissions
+# Then say: "Loki Mode with PRD at ./my-prd.md"
 
-Also available via **npm**, **Homebrew**, **Docker**, **GitHub Action**, and **VS Code Extension**. See [docs/alternative-installations.md](docs/alternative-installations.md) for details and limitations of each method.
+# Or in Codex CLI:
+codex
+# Then say: "Use Loki Mode with PRD at ./my-prd.md"
 
-### Multi-Provider Support (v5.0.0)
+# Or in Gemini CLI:
+gemini
+# Then say: "Use Loki Mode with PRD at ./my-prd.md"
+```
 
-Loki Mode supports three AI providers:
+### Verify Installation
 
 ```bash
-# Claude Code (default - full features)
-loki start --provider claude ./my-prd.md
+loki --version    # Should print 5.50.0
+loki doctor       # Check skill symlinks and provider availability
+```
+
+### Other Methods
 
-# OpenAI Codex CLI (degraded mode)
-loki start --provider codex ./my-prd.md
+Git clone, Docker, GitHub Action, and VS Code Extension are also available. See [docs/alternative-installations.md](docs/alternative-installations.md).
 
-# Google Gemini CLI (degraded mode)
-loki start --provider gemini ./my-prd.md
+### Update
 
-# Or via environment variable
-LOKI_PROVIDER=codex loki start ./my-prd.md
+```bash
+npm update -g loki-mode    # npm
+brew upgrade loki-mode     # Homebrew
 ```
 
-**Provider Comparison:**
+### Multi-Provider Support (v5.0.0)
+
 | Provider | Features | Parallel Agents | Task Tool |
 |----------|----------|-----------------|-----------|
 | Claude | Full | Yes (10+) | Yes |

package/SKILL.md

@@ -3,7 +3,7 @@ name: loki-mode
 description: Multi-agent autonomous startup system. Triggers on "Loki Mode". Takes PRD to deployed product with minimal human intervention. Requires --dangerously-skip-permissions flag.
 ---
 
-# Loki Mode v5.49.3
+# Loki Mode v5.50.0
 
 **You are an autonomous agent. You make decisions. You do not ask questions. You do not stop.**
 
@@ -263,4 +263,4 @@ The following features are documented in skill modules but not yet fully automat
 | Quality gates 3-reviewer system | Implemented (v5.35.0) | 5 specialist reviewers in `skills/quality-gates.md`; execution in run.sh |
 | Benchmarks (HumanEval, SWE-bench) | Infrastructure only | Runner scripts and datasets exist in `benchmarks/`; no published results |
 
-**v5.49.3 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**
+**v5.50.0 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**

package/VERSION

@@ -1 +1 @@
-5.49.3
+5.50.0

package/autonomy/loki

@@ -340,7 +340,8 @@ show_help() {
     echo "  dogfood          Show self-development statistics"
     echo "  secrets [cmd]    API key status and validation (status|validate)"
     echo "  reset [target]   Reset session state (all|retries|failed)"
-    echo "  doctor [--json]  Check system prerequisites"
+    echo "  doctor [--json]  Check system prerequisites and skill symlinks"
+    echo "  setup-skill      Create skill symlinks for all providers"
     echo "  watchdog [cmd]   Process health monitoring (status|help)"
     echo "  version          Show version"
     echo "  help             Show this help"
@@ -2860,6 +2861,69 @@ cmd_config_path() {
     echo "Create a config file with: loki config init"
 }
 
+# Set up skill symlinks for all providers
+cmd_setup_skill() {
+    echo -e "${BOLD}Loki Mode Skill Setup${NC}"
+    echo ""
+
+    local skill_targets=(
+        "$HOME/.claude/skills/loki-mode:Claude Code"
+        "$HOME/.codex/skills/loki-mode:Codex CLI"
+        "$HOME/.gemini/skills/loki-mode:Gemini CLI"
+    )
+
+    local created=0
+    local skipped=0
+    local failed=0
+
+    for entry in "${skill_targets[@]}"; do
+        local target_dir="${entry%%:*}"
+        local target_name="${entry#*:}"
+        local parent_dir
+        parent_dir=$(dirname "$target_dir")
+        local short_path="${target_dir/#$HOME/\~}"
+
+        # Already exists and valid
+        if [ -f "$target_dir/SKILL.md" ]; then
+            echo -e "  ${GREEN}OK${NC}    $target_name  ${DIM}($short_path)${NC}"
+            skipped=$((skipped + 1))
+            continue
+        fi
+
+        # Remove broken symlink
+        if [ -L "$target_dir" ]; then
+            rm -f "$target_dir"
+        fi
+
+        # Create parent directory
+        if [ ! -d "$parent_dir" ]; then
+            mkdir -p "$parent_dir" 2>/dev/null || true
+        fi
+
+        # Create symlink to skill dir
+        if ln -sf "$SKILL_DIR" "$target_dir" 2>/dev/null; then
+            echo -e "  ${GREEN}NEW${NC}   $target_name  ${DIM}($short_path)${NC}"
+            created=$((created + 1))
+        else
+            echo -e "  ${RED}FAIL${NC}  $target_name  ${DIM}($short_path)${NC}"
+            failed=$((failed + 1))
+        fi
+    done
+
+    echo ""
+    if [ "$created" -gt 0 ]; then
+        echo -e "${GREEN}Created $created new skill symlink(s).${NC}"
+    fi
+    if [ "$skipped" -gt 0 ]; then
+        echo -e "${DIM}$skipped already installed.${NC}"
+    fi
+    if [ "$failed" -gt 0 ]; then
+        echo -e "${RED}$failed failed (check permissions).${NC}"
+        return 1
+    fi
+    return 0
+}
+
 # Check system prerequisites
 cmd_doctor() {
     local json_output=false
@@ -3001,6 +3065,29 @@ cmd_doctor() {
     doctor_check "Gemini CLI"          gemini   optional
     echo ""
 
+    echo -e "${CYAN}Skills:${NC}"
+    local skill_dirs=(
+        "$HOME/.claude/skills/loki-mode:Claude Code"
+        "$HOME/.codex/skills/loki-mode:Codex CLI"
+        "$HOME/.gemini/skills/loki-mode:Gemini CLI"
+    )
+    for entry in "${skill_dirs[@]}"; do
+        local sdir="${entry%%:*}"
+        local sname="${entry#*:}"
+        local short_path="${sdir/$HOME/~}"
+        if [ -f "$sdir/SKILL.md" ]; then
+            echo -e "  ${GREEN}PASS${NC}  $sname  ${DIM}$short_path${NC}"
+            pass_count=$((pass_count + 1))
+        elif [ -L "$sdir" ]; then
+            echo -e "  ${RED}FAIL${NC}  $sname  ${DIM}(broken symlink at $short_path)${NC}"
+            fail_count=$((fail_count + 1))
+        else
+            echo -e "  ${YELLOW}WARN${NC}  $sname  ${DIM}(not found - run 'loki setup-skill')${NC}"
+            warn_count=$((warn_count + 1))
+        fi
+    done
+    echo ""
+
     echo -e "${CYAN}System:${NC}"
     doctor_check "bash (>= 4.0)"      bash     recommended  4.0
 
@@ -4679,6 +4766,9 @@ main() {
         doctor)
             cmd_doctor "$@"
             ;;
+        setup-skill)
+            cmd_setup_skill "$@"
+            ;;
         watchdog)
             cmd_watchdog "$@"
             ;;

package/bin/postinstall.js

@@ -9,7 +9,6 @@ const path = require('path');
 const os = require('os');
 
 const homeDir = os.homedir();
-const skillDir = path.join(homeDir, '.claude', 'skills', 'loki-mode');
 const packageDir = path.join(__dirname, '..');
 
 const version = (() => {
@@ -21,73 +20,79 @@ console.log('');
 console.log(`Loki Mode v${version} installed!`);
 console.log('');
 
-// Try to create skill symlink
-try {
-  const skillParent = path.dirname(skillDir);
+// Multi-provider skill targets
+const skillTargets = [
+  { dir: path.join(homeDir, '.claude', 'skills', 'loki-mode'), name: 'Claude Code' },
+  { dir: path.join(homeDir, '.codex', 'skills', 'loki-mode'), name: 'Codex CLI' },
+  { dir: path.join(homeDir, '.gemini', 'skills', 'loki-mode'), name: 'Gemini CLI' },
+];
 
-  if (!fs.existsSync(skillParent)) {
-    fs.mkdirSync(skillParent, { recursive: true });
-  }
+const results = [];
+
+for (const target of skillTargets) {
+  try {
+    const skillParent = path.dirname(target.dir);
 
-  // Remove existing symlink/directory
-  if (fs.existsSync(skillDir)) {
-    const stats = fs.lstatSync(skillDir);
-    if (stats.isSymbolicLink()) {
-      fs.unlinkSync(skillDir);
-    } else {
-      // Existing real directory (not a symlink) - back it up and replace
-      const backupDir = skillDir + '.backup.' + Date.now();
-      console.log(`[WARNING] Existing non-symlink installation found at ${skillDir}`);
-      console.log(`  Active version: ${skillDir}`);
-      console.log(`  npm version:    ${packageDir}`);
-      console.log('');
-      console.log(`Backing up existing installation to: ${backupDir}`);
-      try {
-        fs.renameSync(skillDir, backupDir);
-        console.log('Backup complete. Creating symlink to npm installation.');
-        console.log('');
-        console.log(`To restore the old installation later:`);
-        console.log(`  rm "${skillDir}" && mv "${backupDir}" "${skillDir}"`);
-        console.log('');
-      } catch (backupErr) {
-        console.log(`Could not back up existing installation: ${backupErr.message}`);
-        console.log('');
-        console.log('To fix manually, remove the existing directory and reinstall:');
-        console.log(`  rm -rf "${skillDir}"`);
-        console.log('  npm install -g loki-mode');
-        console.log('');
+    if (!fs.existsSync(skillParent)) {
+      fs.mkdirSync(skillParent, { recursive: true });
+    }
+
+    // Remove existing symlink/directory
+    if (fs.existsSync(target.dir)) {
+      const stats = fs.lstatSync(target.dir);
+      if (stats.isSymbolicLink()) {
+        fs.unlinkSync(target.dir);
+      } else {
+        // Existing real directory (not a symlink) - back it up and replace
+        const backupDir = target.dir + '.backup.' + Date.now();
+        console.log(`[WARNING] Existing non-symlink installation found at ${target.dir}`);
+        console.log(`  Backing up to: ${backupDir}`);
+        try {
+          fs.renameSync(target.dir, backupDir);
+        } catch (backupErr) {
+          console.log(`  Could not back up: ${backupErr.message}`);
+          results.push({ name: target.name, path: target.dir, ok: false });
+          continue;
+        }
       }
     }
+
+    // Create symlink
+    if (!fs.existsSync(target.dir)) {
+      fs.symlinkSync(packageDir, target.dir);
+    }
+    results.push({ name: target.name, path: target.dir, ok: true });
+  } catch (err) {
+    results.push({ name: target.name, path: target.dir, ok: false, error: err.message });
   }
+}
 
-  // Create symlink
-  if (!fs.existsSync(skillDir)) {
-    fs.symlinkSync(packageDir, skillDir);
-    console.log(`Skill installed to: ${skillDir}`);
+// Print summary
+console.log('Skills installed:');
+for (const r of results) {
+  const icon = r.ok ? 'OK' : 'SKIP';
+  const shortPath = r.path.replace(homeDir, '~');
+  if (r.ok) {
+    console.log(`  [${icon}] ${r.name.padEnd(12)} (${shortPath})`);
+  } else {
+    console.log(`  [${icon}] ${r.name.padEnd(12)} (${shortPath}) - ${r.error || 'backup failed'}`);
   }
-} catch (err) {
-  console.log(`Could not auto-install skill: ${err.message}`);
+}
+
+if (results.some(r => !r.ok)) {
   console.log('');
-  console.log('Manual installation:');
-  console.log(`  ln -sf "${packageDir}" "${skillDir}"`);
+  console.log('To fix missing symlinks:');
+  console.log(`  loki setup-skill`);
 }
 
 console.log('');
-console.log('Usage:');
-console.log('  loki start [PRD]              - Start with Claude (default)');
-console.log('  loki start --provider codex   - Start with OpenAI Codex');
-console.log('  loki start --provider gemini  - Start with Google Gemini');
-console.log('  loki status                   - Check status');
-console.log('  loki --help                   - Show all commands');
-console.log('');
-console.log('Providers:');
-console.log('  claude  - Full features (parallel agents, Task tool, MCP)');
-console.log('  codex   - Degraded mode (sequential only)');
-console.log('  gemini  - Degraded mode (sequential only)');
-console.log('');
-console.log('Or in Claude Code:');
-console.log('  claude --dangerously-skip-permissions');
-console.log('  Then say: "Loki Mode"');
+console.log('CLI commands:');
+console.log('  loki start ./prd.md              Start with Claude (default)');
+console.log('  loki start --provider codex      Start with OpenAI Codex');
+console.log('  loki start --provider gemini     Start with Google Gemini');
+console.log('  loki status                      Check status');
+console.log('  loki doctor                      Verify installation');
+console.log('  loki --help                      Show all commands');
 console.log('');
 
 // Anonymous install telemetry (fire-and-forget, silent)
@@ -113,6 +118,7 @@ try {
         version: version,
         channel: 'npm',
         node_version: process.version,
+        providers_installed: results.filter(r => r.ok).map(r => r.name).join(','),
       },
     });
     const req = https.request({

package/dashboard/__init__.py

@@ -7,7 +7,7 @@ Modules:
     control: Session control API (start/stop/pause/resume)
 """
 
-__version__ = "5.49.3"
+__version__ = "5.50.0"
 
 # Expose the control app for easy import
 try:

package/docs/INSTALLATION.md

@@ -2,7 +2,7 @@
 
 The flagship product of [Autonomi](https://www.autonomi.dev/). Complete installation instructions for all platforms and use cases.
 
-**Version:** v5.49.3
+**Version:** v5.50.0
 
 ---
 
@@ -34,36 +34,95 @@ The flagship product of [Autonomi](https://www.autonomi.dev/). Complete installa
 
 ## Table of Contents
 
-- [Quick Install (Recommended)](#quick-install-recommended)
+- [npm (Recommended)](#npm-recommended)
+- [Homebrew](#homebrew)
+- [Quick Start](#quick-start)
+- [Verify Installation](#verify-installation)
+- [Other Methods](#other-methods)
 - [VS Code Extension](#vs-code-extension)
-- [Alternative Methods](#alternative-methods)
 - [Sandbox Mode](#sandbox-mode)
 - [Multi-Provider Support](#multi-provider-support)
 - [Claude Code (CLI)](#claude-code-cli)
 - [Claude.ai (Web)](#claudeai-web)
 - [Anthropic API Console](#anthropic-api-console)
-- [Verify Installation](#verify-installation)
 - [Ports](#ports)
 - [Shell Completions](#shell-completions)
 - [Troubleshooting](#troubleshooting)
 
 ---
 
-## Quick Install (Recommended)
+## npm (Recommended)
 
 ```bash
-git clone https://github.com/asklokesh/loki-mode.git ~/.claude/skills/loki-mode
+npm install -g loki-mode
+```
+
+Installs the `loki` CLI and automatically sets up the skill for Claude Code, Codex CLI, and Gemini CLI via the postinstall script.
+
+**Prerequisites:** Node.js 16+
+
+**What it does:**
+- Installs the `loki` CLI binary to your PATH
+- Creates skill symlinks at `~/.claude/skills/loki-mode`, `~/.codex/skills/loki-mode`, and `~/.gemini/skills/loki-mode`
+- Each provider auto-discovers skills in its respective directory
+
+**Opt out of anonymous install telemetry:**
+```bash
+LOKI_TELEMETRY_DISABLED=true npm install -g loki-mode
+# Or set DO_NOT_TRACK=1
+```
+
+**Update:** `npm update -g loki-mode`
+
+**Uninstall:** `npm uninstall -g loki-mode`
+
+---
+
+## Homebrew
+
+```bash
+brew tap asklokesh/tap && brew install loki-mode
+```
+
+Installs the `loki` CLI. To also install the skill for interactive use with all providers:
+
+```bash
+loki setup-skill
+```
+
+**Update:** `brew upgrade loki-mode`
+
+**Uninstall:** `brew uninstall loki-mode`
+
+---
+
+## Quick Start
+
+```bash
+# CLI mode (works with any provider)
+loki start ./prd.md
+loki start ./prd.md --provider codex
+loki start ./prd.md --provider gemini
+
+# Interactive mode (inside your coding agent)
+claude --dangerously-skip-permissions
+# Then say: "Loki Mode with PRD at ./my-prd.md"
 ```
 
-That's it. Claude Code auto-discovers skills in `~/.claude/skills/`.
+---
+
+## Verify Installation
 
-**Update:** `cd ~/.claude/skills/loki-mode && git pull`
+```bash
+loki --version    # Should print the current version
+loki doctor       # Check skill symlinks, providers, and system prerequisites
+```
 
-Skip to [Verify Installation](#verify-installation) to confirm it's working.
+---
 
-### Alternative Installation Methods
+## Other Methods
 
-Also available via npm, Homebrew, Docker, VS Code Extension, and GitHub Action. Each has trade-offs -- see [docs/alternative-installations.md](alternative-installations.md) for details, limitations, and current status of each method.
+Git clone, Docker, GitHub Action, and VS Code Extension are also available. See [alternative-installations.md](alternative-installations.md) for details and trade-offs.
 
 ---
 
@@ -139,45 +198,6 @@ The extension will automatically connect when it detects the server is running a
 
 ---
 
-## Alternative Methods
-
-The following installation methods are available but each has limitations. Git clone (above) is the recommended primary method.
-
-For full details, troubleshooting, and current status of each method, see [alternative-installations.md](alternative-installations.md).
-
-### npm
-
-**Status:** Published to npm registry. Verify current version: `npm view loki-mode version`
-
-```bash
-npm install -g loki-mode
-```
-
-Requires Node.js 16+. Provides the `loki` CLI and auto-installs the skill to `~/.claude/skills/loki-mode`.
-
-### Homebrew
-
-**Status:** Available via tap. Verify formula: `brew info asklokesh/tap/loki-mode`
-
-```bash
-brew tap asklokesh/tap && brew install loki-mode
-# Manual symlink required for Claude Code:
-ln -sf "$(brew --prefix)/opt/loki-mode/libexec" ~/.claude/skills/loki-mode
-```
-
-### Docker
-
-**Status:** Published to Docker Hub.
-
-```bash
-docker pull asklokesh/loki-mode:latest
-docker run -v $(pwd):/workspace -w /workspace asklokesh/loki-mode:latest start ./my-prd.md
-```
-
-**Limitation:** Docker cannot run Claude Code interactively (Claude Code is a terminal-based CLI requiring TTY access). Docker is suitable for CI/CD pipelines, API-only modes, and sandbox execution -- not for the primary interactive workflow.
-
----
-
 ## Sandbox Mode
 
 Run Loki Mode in an isolated Docker container for enhanced security.