loki-mode 5.49.3 → 5.49.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -11,7 +11,7 @@
11
11
  [![Agent Types](https://img.shields.io/badge/Agent%20Types-41-blue)]()
12
12
  [![Benchmarks](https://img.shields.io/badge/Benchmarks-Infrastructure%20Ready-blue)](benchmarks/)
13
13
 
14
- **Current Version: v5.49.3**
14
+ **Current Version: v5.49.4**
15
15
 
16
16
  **[Autonomi](https://www.autonomi.dev/)** | **[Documentation](https://www.autonomi.dev/docs)** | **[GitHub](https://github.com/asklokesh/loki-mode)**
17
17
 
@@ -41,56 +41,67 @@
41
41
 
42
42
  ## Installation
43
43
 
44
+ ### npm (Recommended)
45
+
44
46
  ```bash
45
- git clone https://github.com/asklokesh/loki-mode.git ~/.claude/skills/loki-mode
47
+ npm install -g loki-mode
46
48
  ```
47
49
 
48
- That's it. Claude Code auto-discovers skills in `~/.claude/skills/`.
50
+ Installs the `loki` CLI and automatically sets up the skill for Claude Code, Codex CLI, and Gemini CLI.
49
51
 
50
- ### Use It
52
+ ### Homebrew
51
53
 
52
54
  ```bash
53
- claude --dangerously-skip-permissions
54
- # Then say: "Loki Mode with PRD at ./my-prd.md"
55
+ brew tap asklokesh/tap && brew install loki-mode
55
56
  ```
56
57
 
57
- ### Update
58
+ Installs the `loki` CLI. To also install the skill for interactive use:
58
59
 
59
60
  ```bash
60
- cd ~/.claude/skills/loki-mode && git pull
61
+ loki setup-skill
61
62
  ```
62
63
 
63
- ### Troubleshooting
64
+ ### Quick Start
64
65
 
65
- | Problem | Fix |
66
- |---------|-----|
67
- | `SKILL.md` not found | Verify: `ls ~/.claude/skills/loki-mode/SKILL.md` |
68
- | Claude doesn't recognize "Loki Mode" | Restart Claude Code after cloning |
69
- | Permission denied on clone | Check SSH keys or use HTTPS URL above |
66
+ ```bash
67
+ # CLI mode (works with any provider)
68
+ loki start ./prd.md
69
+ loki start ./prd.md --provider codex
70
+ loki start ./prd.md --provider gemini
70
71
 
71
- ### Other Installation Methods
72
+ # Interactive mode (inside your coding agent)
73
+ claude --dangerously-skip-permissions
74
+ # Then say: "Loki Mode with PRD at ./my-prd.md"
72
75
 
73
- 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.
76
+ # Or in Codex CLI:
77
+ codex
78
+ # Then say: "Use Loki Mode with PRD at ./my-prd.md"
74
79
 
75
- ### Multi-Provider Support (v5.0.0)
80
+ # Or in Gemini CLI:
81
+ gemini
82
+ # Then say: "Use Loki Mode with PRD at ./my-prd.md"
83
+ ```
76
84
 
77
- Loki Mode supports three AI providers:
85
+ ### Verify Installation
78
86
 
79
87
  ```bash
80
- # Claude Code (default - full features)
81
- loki start --provider claude ./my-prd.md
88
+ loki --version # Should print 5.49.4
89
+ loki doctor # Check skill symlinks and provider availability
90
+ ```
91
+
92
+ ### Other Methods
82
93
 
83
- # OpenAI Codex CLI (degraded mode)
84
- loki start --provider codex ./my-prd.md
94
+ Git clone, Docker, GitHub Action, and VS Code Extension are also available. See [docs/alternative-installations.md](docs/alternative-installations.md).
85
95
 
86
- # Google Gemini CLI (degraded mode)
87
- loki start --provider gemini ./my-prd.md
96
+ ### Update
88
97
 
89
- # Or via environment variable
90
- LOKI_PROVIDER=codex loki start ./my-prd.md
98
+ ```bash
99
+ npm update -g loki-mode # npm
100
+ brew upgrade loki-mode # Homebrew
91
101
  ```
92
102
 
93
- **Provider Comparison:**
103
+ ### Multi-Provider Support (v5.0.0)
104
+
94
105
  | Provider | Features | Parallel Agents | Task Tool |
95
106
  |----------|----------|-----------------|-----------|
96
107
  | Claude | Full | Yes (10+) | Yes |
package/SKILL.md CHANGED
@@ -3,7 +3,7 @@ name: loki-mode
3
3
  description: Multi-agent autonomous startup system. Triggers on "Loki Mode". Takes PRD to deployed product with minimal human intervention. Requires --dangerously-skip-permissions flag.
4
4
  ---
5
5
 
6
- # Loki Mode v5.49.3
6
+ # Loki Mode v5.49.4
7
7
 
8
8
  **You are an autonomous agent. You make decisions. You do not ask questions. You do not stop.**
9
9
 
@@ -263,4 +263,4 @@ The following features are documented in skill modules but not yet fully automat
263
263
  | Quality gates 3-reviewer system | Implemented (v5.35.0) | 5 specialist reviewers in `skills/quality-gates.md`; execution in run.sh |
264
264
  | Benchmarks (HumanEval, SWE-bench) | Infrastructure only | Runner scripts and datasets exist in `benchmarks/`; no published results |
265
265
 
266
- **v5.49.3 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**
266
+ **v5.49.4 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**
package/VERSION CHANGED
@@ -1 +1 @@
1
- 5.49.3
1
+ 5.49.4
package/autonomy/loki CHANGED
@@ -340,7 +340,8 @@ show_help() {
340
340
  echo " dogfood Show self-development statistics"
341
341
  echo " secrets [cmd] API key status and validation (status|validate)"
342
342
  echo " reset [target] Reset session state (all|retries|failed)"
343
- echo " doctor [--json] Check system prerequisites"
343
+ echo " doctor [--json] Check system prerequisites and skill symlinks"
344
+ echo " setup-skill Create skill symlinks for all providers"
344
345
  echo " watchdog [cmd] Process health monitoring (status|help)"
345
346
  echo " version Show version"
346
347
  echo " help Show this help"
@@ -2860,6 +2861,69 @@ cmd_config_path() {
2860
2861
  echo "Create a config file with: loki config init"
2861
2862
  }
2862
2863
 
2864
+ # Set up skill symlinks for all providers
2865
+ cmd_setup_skill() {
2866
+ echo -e "${BOLD}Loki Mode Skill Setup${NC}"
2867
+ echo ""
2868
+
2869
+ local skill_targets=(
2870
+ "$HOME/.claude/skills/loki-mode:Claude Code"
2871
+ "$HOME/.codex/skills/loki-mode:Codex CLI"
2872
+ "$HOME/.gemini/skills/loki-mode:Gemini CLI"
2873
+ )
2874
+
2875
+ local created=0
2876
+ local skipped=0
2877
+ local failed=0
2878
+
2879
+ for entry in "${skill_targets[@]}"; do
2880
+ local target_dir="${entry%%:*}"
2881
+ local target_name="${entry#*:}"
2882
+ local parent_dir
2883
+ parent_dir=$(dirname "$target_dir")
2884
+ local short_path="${target_dir/#$HOME/\~}"
2885
+
2886
+ # Already exists and valid
2887
+ if [ -f "$target_dir/SKILL.md" ]; then
2888
+ echo -e " ${GREEN}OK${NC} $target_name ${DIM}($short_path)${NC}"
2889
+ skipped=$((skipped + 1))
2890
+ continue
2891
+ fi
2892
+
2893
+ # Remove broken symlink
2894
+ if [ -L "$target_dir" ]; then
2895
+ rm -f "$target_dir"
2896
+ fi
2897
+
2898
+ # Create parent directory
2899
+ if [ ! -d "$parent_dir" ]; then
2900
+ mkdir -p "$parent_dir" 2>/dev/null || true
2901
+ fi
2902
+
2903
+ # Create symlink to skill dir
2904
+ if ln -sf "$SKILL_DIR" "$target_dir" 2>/dev/null; then
2905
+ echo -e " ${GREEN}NEW${NC} $target_name ${DIM}($short_path)${NC}"
2906
+ created=$((created + 1))
2907
+ else
2908
+ echo -e " ${RED}FAIL${NC} $target_name ${DIM}($short_path)${NC}"
2909
+ failed=$((failed + 1))
2910
+ fi
2911
+ done
2912
+
2913
+ echo ""
2914
+ if [ "$created" -gt 0 ]; then
2915
+ echo -e "${GREEN}Created $created new skill symlink(s).${NC}"
2916
+ fi
2917
+ if [ "$skipped" -gt 0 ]; then
2918
+ echo -e "${DIM}$skipped already installed.${NC}"
2919
+ fi
2920
+ if [ "$failed" -gt 0 ]; then
2921
+ echo -e "${RED}$failed failed (check permissions).${NC}"
2922
+ return 1
2923
+ fi
2924
+ return 0
2925
+ }
2926
+
2863
2927
  # Check system prerequisites
2864
2928
  cmd_doctor() {
2865
2929
  local json_output=false
@@ -3001,6 +3065,29 @@ cmd_doctor() {
3001
3065
  doctor_check "Gemini CLI" gemini optional
3002
3066
  echo ""
3003
3067
 
3068
+ echo -e "${CYAN}Skills:${NC}"
3069
+ local skill_dirs=(
3070
+ "$HOME/.claude/skills/loki-mode:Claude Code"
3071
+ "$HOME/.codex/skills/loki-mode:Codex CLI"
3072
+ "$HOME/.gemini/skills/loki-mode:Gemini CLI"
3073
+ )
3074
+ for entry in "${skill_dirs[@]}"; do
3075
+ local sdir="${entry%%:*}"
3076
+ local sname="${entry#*:}"
3077
+ local short_path="${sdir/$HOME/~}"
3078
+ if [ -f "$sdir/SKILL.md" ]; then
3079
+ echo -e " ${GREEN}PASS${NC} $sname ${DIM}$short_path${NC}"
3080
+ pass_count=$((pass_count + 1))
3081
+ elif [ -L "$sdir" ]; then
3082
+ echo -e " ${RED}FAIL${NC} $sname ${DIM}(broken symlink at $short_path)${NC}"
3083
+ fail_count=$((fail_count + 1))
3084
+ else
3085
+ echo -e " ${YELLOW}WARN${NC} $sname ${DIM}(not found - run 'loki setup-skill')${NC}"
3086
+ warn_count=$((warn_count + 1))
3087
+ fi
3088
+ done
3089
+ echo ""
3090
+
3004
3091
  echo -e "${CYAN}System:${NC}"
3005
3092
  doctor_check "bash (>= 4.0)" bash recommended 4.0
3006
3093
 
@@ -4679,6 +4766,9 @@ main() {
4679
4766
  doctor)
4680
4767
  cmd_doctor "$@"
4681
4768
  ;;
4769
+ setup-skill)
4770
+ cmd_setup_skill "$@"
4771
+ ;;
4682
4772
  watchdog)
4683
4773
  cmd_watchdog "$@"
4684
4774
  ;;
@@ -9,7 +9,6 @@ const path = require('path');
9
9
  const os = require('os');
10
10
 
11
11
  const homeDir = os.homedir();
12
- const skillDir = path.join(homeDir, '.claude', 'skills', 'loki-mode');
13
12
  const packageDir = path.join(__dirname, '..');
14
13
 
15
14
  const version = (() => {
@@ -21,73 +20,79 @@ console.log('');
21
20
  console.log(`Loki Mode v${version} installed!`);
22
21
  console.log('');
23
22
 
24
- // Try to create skill symlink
25
- try {
26
- const skillParent = path.dirname(skillDir);
23
+ // Multi-provider skill targets
24
+ const skillTargets = [
25
+ { dir: path.join(homeDir, '.claude', 'skills', 'loki-mode'), name: 'Claude Code' },
26
+ { dir: path.join(homeDir, '.codex', 'skills', 'loki-mode'), name: 'Codex CLI' },
27
+ { dir: path.join(homeDir, '.gemini', 'skills', 'loki-mode'), name: 'Gemini CLI' },
28
+ ];
27
29
 
28
- if (!fs.existsSync(skillParent)) {
29
- fs.mkdirSync(skillParent, { recursive: true });
30
- }
30
+ const results = [];
31
+
32
+ for (const target of skillTargets) {
33
+ try {
34
+ const skillParent = path.dirname(target.dir);
31
35
 
32
- // Remove existing symlink/directory
33
- if (fs.existsSync(skillDir)) {
34
- const stats = fs.lstatSync(skillDir);
35
- if (stats.isSymbolicLink()) {
36
- fs.unlinkSync(skillDir);
37
- } else {
38
- // Existing real directory (not a symlink) - back it up and replace
39
- const backupDir = skillDir + '.backup.' + Date.now();
40
- console.log(`[WARNING] Existing non-symlink installation found at ${skillDir}`);
41
- console.log(` Active version: ${skillDir}`);
42
- console.log(` npm version: ${packageDir}`);
43
- console.log('');
44
- console.log(`Backing up existing installation to: ${backupDir}`);
45
- try {
46
- fs.renameSync(skillDir, backupDir);
47
- console.log('Backup complete. Creating symlink to npm installation.');
48
- console.log('');
49
- console.log(`To restore the old installation later:`);
50
- console.log(` rm "${skillDir}" && mv "${backupDir}" "${skillDir}"`);
51
- console.log('');
52
- } catch (backupErr) {
53
- console.log(`Could not back up existing installation: ${backupErr.message}`);
54
- console.log('');
55
- console.log('To fix manually, remove the existing directory and reinstall:');
56
- console.log(` rm -rf "${skillDir}"`);
57
- console.log(' npm install -g loki-mode');
58
- console.log('');
36
+ if (!fs.existsSync(skillParent)) {
37
+ fs.mkdirSync(skillParent, { recursive: true });
38
+ }
39
+
40
+ // Remove existing symlink/directory
41
+ if (fs.existsSync(target.dir)) {
42
+ const stats = fs.lstatSync(target.dir);
43
+ if (stats.isSymbolicLink()) {
44
+ fs.unlinkSync(target.dir);
45
+ } else {
46
+ // Existing real directory (not a symlink) - back it up and replace
47
+ const backupDir = target.dir + '.backup.' + Date.now();
48
+ console.log(`[WARNING] Existing non-symlink installation found at ${target.dir}`);
49
+ console.log(` Backing up to: ${backupDir}`);
50
+ try {
51
+ fs.renameSync(target.dir, backupDir);
52
+ } catch (backupErr) {
53
+ console.log(` Could not back up: ${backupErr.message}`);
54
+ results.push({ name: target.name, path: target.dir, ok: false });
55
+ continue;
56
+ }
59
57
  }
60
58
  }
59
+
60
+ // Create symlink
61
+ if (!fs.existsSync(target.dir)) {
62
+ fs.symlinkSync(packageDir, target.dir);
63
+ }
64
+ results.push({ name: target.name, path: target.dir, ok: true });
65
+ } catch (err) {
66
+ results.push({ name: target.name, path: target.dir, ok: false, error: err.message });
61
67
  }
68
+ }
62
69
 
63
- // Create symlink
64
- if (!fs.existsSync(skillDir)) {
65
- fs.symlinkSync(packageDir, skillDir);
66
- console.log(`Skill installed to: ${skillDir}`);
70
+ // Print summary
71
+ console.log('Skills installed:');
72
+ for (const r of results) {
73
+ const icon = r.ok ? 'OK' : 'SKIP';
74
+ const shortPath = r.path.replace(homeDir, '~');
75
+ if (r.ok) {
76
+ console.log(` [${icon}] ${r.name.padEnd(12)} (${shortPath})`);
77
+ } else {
78
+ console.log(` [${icon}] ${r.name.padEnd(12)} (${shortPath}) - ${r.error || 'backup failed'}`);
67
79
  }
68
- } catch (err) {
69
- console.log(`Could not auto-install skill: ${err.message}`);
80
+ }
81
+
82
+ if (results.some(r => !r.ok)) {
70
83
  console.log('');
71
- console.log('Manual installation:');
72
- console.log(` ln -sf "${packageDir}" "${skillDir}"`);
84
+ console.log('To fix missing symlinks:');
85
+ console.log(` loki setup-skill`);
73
86
  }
74
87
 
75
88
  console.log('');
76
- console.log('Usage:');
77
- console.log(' loki start [PRD] - Start with Claude (default)');
78
- console.log(' loki start --provider codex - Start with OpenAI Codex');
79
- console.log(' loki start --provider gemini - Start with Google Gemini');
80
- console.log(' loki status - Check status');
81
- console.log(' loki --help - Show all commands');
82
- console.log('');
83
- console.log('Providers:');
84
- console.log(' claude - Full features (parallel agents, Task tool, MCP)');
85
- console.log(' codex - Degraded mode (sequential only)');
86
- console.log(' gemini - Degraded mode (sequential only)');
87
- console.log('');
88
- console.log('Or in Claude Code:');
89
- console.log(' claude --dangerously-skip-permissions');
90
- console.log(' Then say: "Loki Mode"');
89
+ console.log('CLI commands:');
90
+ console.log(' loki start ./prd.md Start with Claude (default)');
91
+ console.log(' loki start --provider codex Start with OpenAI Codex');
92
+ console.log(' loki start --provider gemini Start with Google Gemini');
93
+ console.log(' loki status Check status');
94
+ console.log(' loki doctor Verify installation');
95
+ console.log(' loki --help Show all commands');
91
96
  console.log('');
92
97
 
93
98
  // Anonymous install telemetry (fire-and-forget, silent)
@@ -113,6 +118,7 @@ try {
113
118
  version: version,
114
119
  channel: 'npm',
115
120
  node_version: process.version,
121
+ providers_installed: results.filter(r => r.ok).map(r => r.name).join(','),
116
122
  },
117
123
  });
118
124
  const req = https.request({
@@ -7,7 +7,7 @@ Modules:
7
7
  control: Session control API (start/stop/pause/resume)
8
8
  """
9
9
 
10
- __version__ = "5.49.3"
10
+ __version__ = "5.49.4"
11
11
 
12
12
  # Expose the control app for easy import
13
13
  try:
@@ -2,7 +2,7 @@
2
2
 
3
3
  The flagship product of [Autonomi](https://www.autonomi.dev/). Complete installation instructions for all platforms and use cases.
4
4
 
5
- **Version:** v5.49.3
5
+ **Version:** v5.49.4
6
6
 
7
7
  ---
8
8
 
@@ -34,36 +34,95 @@ The flagship product of [Autonomi](https://www.autonomi.dev/). Complete installa
34
34
 
35
35
  ## Table of Contents
36
36
 
37
- - [Quick Install (Recommended)](#quick-install-recommended)
37
+ - [npm (Recommended)](#npm-recommended)
38
+ - [Homebrew](#homebrew)
39
+ - [Quick Start](#quick-start)
40
+ - [Verify Installation](#verify-installation)
41
+ - [Other Methods](#other-methods)
38
42
  - [VS Code Extension](#vs-code-extension)
39
- - [Alternative Methods](#alternative-methods)
40
43
  - [Sandbox Mode](#sandbox-mode)
41
44
  - [Multi-Provider Support](#multi-provider-support)
42
45
  - [Claude Code (CLI)](#claude-code-cli)
43
46
  - [Claude.ai (Web)](#claudeai-web)
44
47
  - [Anthropic API Console](#anthropic-api-console)
45
- - [Verify Installation](#verify-installation)
46
48
  - [Ports](#ports)
47
49
  - [Shell Completions](#shell-completions)
48
50
  - [Troubleshooting](#troubleshooting)
49
51
 
50
52
  ---
51
53
 
52
- ## Quick Install (Recommended)
54
+ ## npm (Recommended)
53
55
 
54
56
  ```bash
55
- git clone https://github.com/asklokesh/loki-mode.git ~/.claude/skills/loki-mode
57
+ npm install -g loki-mode
58
+ ```
59
+
60
+ Installs the `loki` CLI and automatically sets up the skill for Claude Code, Codex CLI, and Gemini CLI via the postinstall script.
61
+
62
+ **Prerequisites:** Node.js 16+
63
+
64
+ **What it does:**
65
+ - Installs the `loki` CLI binary to your PATH
66
+ - Creates skill symlinks at `~/.claude/skills/loki-mode`, `~/.codex/skills/loki-mode`, and `~/.gemini/skills/loki-mode`
67
+ - Each provider auto-discovers skills in its respective directory
68
+
69
+ **Opt out of anonymous install telemetry:**
70
+ ```bash
71
+ LOKI_TELEMETRY_DISABLED=true npm install -g loki-mode
72
+ # Or set DO_NOT_TRACK=1
73
+ ```
74
+
75
+ **Update:** `npm update -g loki-mode`
76
+
77
+ **Uninstall:** `npm uninstall -g loki-mode`
78
+
79
+ ---
80
+
81
+ ## Homebrew
82
+
83
+ ```bash
84
+ brew tap asklokesh/tap && brew install loki-mode
85
+ ```
86
+
87
+ Installs the `loki` CLI. To also install the skill for interactive use with all providers:
88
+
89
+ ```bash
90
+ loki setup-skill
91
+ ```
92
+
93
+ **Update:** `brew upgrade loki-mode`
94
+
95
+ **Uninstall:** `brew uninstall loki-mode`
96
+
97
+ ---
98
+
99
+ ## Quick Start
100
+
101
+ ```bash
102
+ # CLI mode (works with any provider)
103
+ loki start ./prd.md
104
+ loki start ./prd.md --provider codex
105
+ loki start ./prd.md --provider gemini
106
+
107
+ # Interactive mode (inside your coding agent)
108
+ claude --dangerously-skip-permissions
109
+ # Then say: "Loki Mode with PRD at ./my-prd.md"
56
110
  ```
57
111
 
58
- That's it. Claude Code auto-discovers skills in `~/.claude/skills/`.
112
+ ---
113
+
114
+ ## Verify Installation
59
115
 
60
- **Update:** `cd ~/.claude/skills/loki-mode && git pull`
116
+ ```bash
117
+ loki --version # Should print the current version
118
+ loki doctor # Check skill symlinks, providers, and system prerequisites
119
+ ```
61
120
 
62
- Skip to [Verify Installation](#verify-installation) to confirm it's working.
121
+ ---
63
122
 
64
- ### Alternative Installation Methods
123
+ ## Other Methods
65
124
 
66
- 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.
125
+ Git clone, Docker, GitHub Action, and VS Code Extension are also available. See [alternative-installations.md](alternative-installations.md) for details and trade-offs.
67
126
 
68
127
  ---
69
128
 
@@ -139,45 +198,6 @@ The extension will automatically connect when it detects the server is running a
139
198
 
140
199
  ---
141
200
 
142
- ## Alternative Methods
143
-
144
- The following installation methods are available but each has limitations. Git clone (above) is the recommended primary method.
145
-
146
- For full details, troubleshooting, and current status of each method, see [alternative-installations.md](alternative-installations.md).
147
-
148
- ### npm
149
-
150
- **Status:** Published to npm registry. Verify current version: `npm view loki-mode version`
151
-
152
- ```bash
153
- npm install -g loki-mode
154
- ```
155
-
156
- Requires Node.js 16+. Provides the `loki` CLI and auto-installs the skill to `~/.claude/skills/loki-mode`.
157
-
158
- ### Homebrew
159
-
160
- **Status:** Available via tap. Verify formula: `brew info asklokesh/tap/loki-mode`
161
-
162
- ```bash
163
- brew tap asklokesh/tap && brew install loki-mode
164
- # Manual symlink required for Claude Code:
165
- ln -sf "$(brew --prefix)/opt/loki-mode/libexec" ~/.claude/skills/loki-mode
166
- ```
167
-
168
- ### Docker
169
-
170
- **Status:** Published to Docker Hub.
171
-
172
- ```bash
173
- docker pull asklokesh/loki-mode:latest
174
- docker run -v $(pwd):/workspace -w /workspace asklokesh/loki-mode:latest start ./my-prd.md
175
- ```
176
-
177
- **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.
178
-
179
- ---
180
-
181
201
  ## Sandbox Mode
182
202
 
183
203
  Run Loki Mode in an isolated Docker container for enhanced security.
@@ -1,70 +1,54 @@
1
1
  # Alternative Installation Methods
2
2
 
3
- The primary installation method is git clone (see [README](../README.md#installation)). These alternatives serve specific use cases.
3
+ The recommended installation is via npm or Homebrew (see [README](../README.md#installation)). These alternatives serve specific use cases.
4
4
 
5
5
  ---
6
6
 
7
- ## npm (Secondary)
7
+ ## Git Clone (Manual)
8
8
 
9
- **Status**: Working. Version tracks releases automatically.
9
+ Best for: contributors, development, or environments without npm/brew.
10
10
 
11
11
  ```bash
12
- npm install -g loki-mode
13
- ```
14
-
15
- **Limitation**: Installs to `node_modules`, not `~/.claude/skills/`. To use as a Claude Code skill, you must symlink:
16
-
17
- ```bash
18
- npm install -g loki-mode
19
- ln -sf "$(npm root -g)/loki-mode" ~/.claude/skills/loki-mode
20
- ```
21
-
22
- **Best for**: CI/CD pipelines, programmatic access via `loki` CLI.
23
-
24
- ---
25
-
26
- ## Homebrew (Secondary)
12
+ # Clone to Claude Code skills directory
13
+ git clone https://github.com/asklokesh/loki-mode.git ~/.claude/skills/loki-mode
27
14
 
28
- **Status**: Working. Tap and formula exist, version current.
15
+ # Optionally symlink for other providers:
16
+ ln -sf ~/.claude/skills/loki-mode ~/.codex/skills/loki-mode
17
+ ln -sf ~/.claude/skills/loki-mode ~/.gemini/skills/loki-mode
29
18
 
30
- ```bash
31
- brew tap asklokesh/tap
32
- brew install loki-mode
19
+ # Optionally add CLI to PATH:
20
+ ln -sf ~/.claude/skills/loki-mode/autonomy/loki /usr/local/bin/loki
33
21
  ```
34
22
 
35
- **Limitation**: Installs the `loki` CLI binary only. Does NOT install the Claude Code skill. To use with Claude Code, also run:
36
-
37
- ```bash
38
- git clone https://github.com/asklokesh/loki-mode.git ~/.claude/skills/loki-mode
39
- ```
23
+ **Update:** `cd ~/.claude/skills/loki-mode && git pull`
40
24
 
41
- **Best for**: Users who want the `loki` CLI wrapper for autonomous mode (`loki start`, `loki stop`, `loki cleanup`).
25
+ **Limitation:** Does not install the `loki` CLI to PATH automatically. You must symlink or add to PATH manually.
42
26
 
43
27
  ---
44
28
 
45
- ## Docker (Secondary)
29
+ ## Docker
46
30
 
47
- **Status**: Image exists on Docker Hub. Tags: `latest`, version-specific (e.g., `5.49.1`).
31
+ **Status:** Image exists on Docker Hub. Tags: `latest`, version-specific (e.g., `5.49.4`).
48
32
 
49
33
  ```bash
50
34
  docker pull asklokesh/loki-mode:latest
51
35
  ```
52
36
 
53
- **Limitation**: Claude Code is an interactive CLI that requires API keys and terminal access. Running it inside a Docker container is not the standard workflow. Docker is useful for:
37
+ **Limitation:** Claude Code is an interactive CLI that requires API keys and terminal access. Running it inside a Docker container is not the standard workflow. Docker is useful for:
54
38
 
55
39
  - CI/CD sandbox execution (running `loki` in isolated environments)
56
40
  - Testing Loki Mode without modifying your local system
57
41
  - Air-gapped environments with pre-built images
58
42
 
59
- **Not recommended for**: Interactive Claude Code sessions. Use the git clone method instead.
43
+ **Not recommended for:** Interactive Claude Code sessions. Use npm or Homebrew instead.
60
44
 
61
45
  See [DOCKER_README.md](../DOCKER_README.md) for Docker-specific usage instructions.
62
46
 
63
47
  ---
64
48
 
65
- ## GitHub Action (Secondary)
49
+ ## GitHub Action
66
50
 
67
- **Status**: Working. Adds automated AI code review to pull requests.
51
+ **Status:** Working. Adds automated AI code review to pull requests.
68
52
 
69
53
  ```yaml
70
54
  # .github/workflows/loki-review.yml
@@ -114,27 +98,27 @@ jobs:
114
98
  | `fix` | Automatically fix issues found in the codebase |
115
99
  | `test` | Run autonomous test generation and validation |
116
100
 
117
- **Best for**: Automated PR review and CI/CD integration.
101
+ **Best for:** Automated PR review and CI/CD integration.
118
102
 
119
103
  ---
120
104
 
121
- ## GitHub Release Download (Secondary)
105
+ ## GitHub Release Download
122
106
 
123
- **Status**: Working. Release assets available for each version.
107
+ **Status:** Working. Release assets available for each version.
124
108
 
125
109
  ```bash
126
110
  # Download and extract to skills directory
127
- curl -sL https://github.com/asklokesh/loki-mode/archive/refs/tags/v5.49.1.tar.gz | tar xz
128
- mv loki-mode-5.49.1 ~/.claude/skills/loki-mode
111
+ curl -sL https://github.com/asklokesh/loki-mode/archive/refs/tags/v5.49.4.tar.gz | tar xz
112
+ mv loki-mode-5.49.4 ~/.claude/skills/loki-mode
129
113
  ```
130
114
 
131
- **Best for**: Offline or air-gapped environments, pinned version deployments.
115
+ **Best for:** Offline or air-gapped environments, pinned version deployments.
132
116
 
133
117
  ---
134
118
 
135
- ## VS Code Extension (Secondary)
119
+ ## VS Code Extension
136
120
 
137
- **Status**: Available on VS Code Marketplace.
121
+ **Status:** Available on VS Code Marketplace.
138
122
 
139
123
  Search for "Loki Mode" in VS Code Extensions, or:
140
124
 
@@ -142,4 +126,4 @@ Search for "Loki Mode" in VS Code Extensions, or:
142
126
  code --install-extension asklokesh.loki-mode
143
127
  ```
144
128
 
145
- **Best for**: VS Code users who want dashboard integration within their editor.
129
+ **Best for:** VS Code users who want dashboard integration within their editor.
package/mcp/__init__.py CHANGED
@@ -21,4 +21,4 @@ try:
21
21
  except ImportError:
22
22
  __all__ = ['mcp']
23
23
 
24
- __version__ = '5.49.3'
24
+ __version__ = '5.49.4'
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "loki-mode",
3
- "version": "5.49.3",
3
+ "version": "5.49.4",
4
4
  "description": "Loki Mode by Autonomi - Multi-agent autonomous startup system for Claude Code, Codex CLI, and Gemini CLI",
5
5
  "keywords": [
6
6
  "autonomi",