loki-mode 4.2.0 → 5.1.2

package/bin/postinstall.js

@@ -13,7 +13,7 @@ const skillDir = path.join(homeDir, '.claude', 'skills', 'loki-mode');
 const packageDir = path.join(__dirname, '..');
 
 console.log('');
-console.log('Loki Mode v4.1.0 installed!');
+console.log('Loki Mode v5.0.0 installed!');
 console.log('');
 
 // Try to create skill symlink
@@ -50,9 +50,16 @@ try {
 
 console.log('');
 console.log('Usage:');
-console.log('  loki start [PRD]    - Start Loki Mode');
-console.log('  loki status         - Check status');
-console.log('  loki --help         - Show all commands');
+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');

package/docs/INSTALLATION.md

@@ -2,7 +2,7 @@
 
 Complete installation instructions for all platforms and use cases.
 
-**Version:** v4.1.0
+**Version:** v5.0.0
 
 ---
 
@@ -12,6 +12,7 @@ Complete installation instructions for all platforms and use cases.
 - [npm (Node.js)](#npm-nodejs)
 - [Homebrew (macOS/Linux)](#homebrew-macoslinux)
 - [Docker](#docker)
+- [Multi-Provider Support](#multi-provider-support)
 - [Claude Code (CLI)](#claude-code-cli)
 - [Claude.ai (Web)](#claudeai-web)
 - [Anthropic API Console](#anthropic-api-console)
@@ -32,7 +33,7 @@ npm install -g loki-mode
 brew tap asklokesh/tap && brew install loki-mode
 
 # Option C: Docker
-docker pull asklokesh/loki-mode:4.1.0
+docker pull asklokesh/loki-mode:5.0.0
 
 # Option D: Git clone
 git clone https://github.com/asklokesh/loki-mode.git ~/.claude/skills/loki-mode
@@ -151,7 +152,7 @@ Run Loki Mode in a container for isolated execution.
 
 ```bash
 # Pull the image
-docker pull asklokesh/loki-mode:4.1.0
+docker pull asklokesh/loki-mode:5.0.0
 
 # Or use docker-compose
 curl -o docker-compose.yml https://raw.githubusercontent.com/asklokesh/loki-mode/main/docker-compose.yml
@@ -161,10 +162,10 @@ curl -o docker-compose.yml https://raw.githubusercontent.com/asklokesh/loki-mode
 
 ```bash
 # Run with a PRD file
-docker run -v $(pwd):/workspace -w /workspace asklokesh/loki-mode:4.1.0 start ./my-prd.md
+docker run -v $(pwd):/workspace -w /workspace asklokesh/loki-mode:5.0.0 start ./my-prd.md
 
 # Interactive mode
-docker run -it -v $(pwd):/workspace -w /workspace asklokesh/loki-mode:4.1.0
+docker run -it -v $(pwd):/workspace -w /workspace asklokesh/loki-mode:5.0.0
 
 # Using docker-compose
 docker-compose run loki start ./my-prd.md
@@ -177,7 +178,7 @@ Pass your configuration via environment variables:
 ```bash
 docker run -e LOKI_MAX_RETRIES=100 -e LOKI_BASE_WAIT=120 \
   -v $(pwd):/workspace -w /workspace \
-  asklokesh/loki-mode:4.1.0 start ./my-prd.md
+  asklokesh/loki-mode:5.0.0 start ./my-prd.md
 ```
 
 ### Updating
@@ -188,6 +189,77 @@ docker pull asklokesh/loki-mode:latest
 
 ---
 
+## Multi-Provider Support
+
+Loki Mode v5.0.0 introduces support for multiple AI providers beyond Claude.
+
+### Supported Providers
+
+| Provider | Status | Notes |
+|----------|--------|-------|
+| `claude` | Full Support | Default provider, all features available |
+| `codex` | Degraded Mode | Core functionality only, some features unavailable |
+| `gemini` | Degraded Mode | Core functionality only, some features unavailable |
+
+### Configuration
+
+#### Environment Variable
+
+Set the `LOKI_PROVIDER` environment variable to select your provider:
+
+```bash
+# Use Claude (default)
+export LOKI_PROVIDER=claude
+
+# Use OpenAI Codex
+export LOKI_PROVIDER=codex
+
+# Use Google Gemini
+export LOKI_PROVIDER=gemini
+```
+
+#### CLI Flag
+
+Use the `--provider` flag when invoking Loki Mode:
+
+```bash
+# Use Claude (default)
+loki start ./my-prd.md --provider claude
+
+# Use OpenAI Codex
+loki start ./my-prd.md --provider codex
+
+# Use Google Gemini
+loki start ./my-prd.md --provider gemini
+```
+
+#### Docker
+
+Pass the provider as an environment variable:
+
+```bash
+# Use Codex with Docker
+docker run -e LOKI_PROVIDER=codex \
+  -v $(pwd):/workspace -w /workspace \
+  asklokesh/loki-mode:5.0.0 start ./my-prd.md
+
+# Use Gemini with Docker
+docker run -e LOKI_PROVIDER=gemini \
+  -v $(pwd):/workspace -w /workspace \
+  asklokesh/loki-mode:5.0.0 start ./my-prd.md
+```
+
+### Degraded Mode
+
+When using `codex` or `gemini` providers, Loki Mode operates in **degraded mode**:
+
+- Core autonomous workflow functions normally
+- Some advanced features may be unavailable or behave differently
+- Model-specific optimizations (Opus/Sonnet/Haiku routing) are adapted for each provider
+- Quality gates and RARV cycle remain fully functional
+
+**Recommendation:** For the best experience and full feature support, use the default `claude` provider.
+
 ---
 
 ## Claude Code (CLI)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "loki-mode",
-  "version": "4.2.0",
-  "description": "Multi-agent autonomous startup system for Claude Code",
+  "version": "5.1.2",
+  "description": "Multi-agent autonomous startup system for Claude Code, Codex CLI, and Gemini CLI",
   "keywords": [
     "claude",
     "claude-code",
@@ -22,13 +22,14 @@
   "license": "MIT",
   "author": "Lokesh",
   "bin": {
-    "loki": "./autonomy/loki",
-    "loki-mode": "./bin/loki-mode.js"
+    "loki": "autonomy/loki",
+    "loki-mode": "bin/loki-mode.js"
   },
   "files": [
     "SKILL.md",
     "VERSION",
     "autonomy/",
+    "providers/",
     "skills/",
     "references/",
     "docs/",

package/providers/claude.sh

@@ -0,0 +1,108 @@
+#!/bin/bash
+# Claude Code Provider Configuration
+# Shell-sourceable config for loki-mode multi-provider support
+
+# Provider Functions (for external use)
+# =====================================
+# These functions provide a clean interface for external scripts:
+#   provider_detect()           - Check if CLI is installed
+#   provider_version()          - Get CLI version
+#   provider_invoke()           - Invoke with prompt (autonomous mode)
+#   provider_invoke_with_tier() - Invoke with tier-specific model selection
+#   provider_get_tier_param()   - Map tier name to model name
+#
+# Usage:
+#   source providers/claude.sh
+#   if provider_detect; then
+#       provider_invoke "Your prompt here"
+#   fi
+#
+# Note: autonomy/run.sh uses inline invocation for streaming support
+# and real-time agent tracking. These functions are intended for
+# simpler scripts, wrappers, and external integrations.
+# =====================================
+
+# Provider Identity
+PROVIDER_NAME="claude"
+PROVIDER_DISPLAY_NAME="Claude Code"
+PROVIDER_CLI="claude"
+
+# CLI Invocation
+PROVIDER_AUTONOMOUS_FLAG="--dangerously-skip-permissions"
+PROVIDER_PROMPT_FLAG="-p"
+PROVIDER_PROMPT_POSITIONAL=false
+
+# Skill System
+PROVIDER_SKILL_DIR="${HOME}/.claude/skills"
+PROVIDER_SKILL_FORMAT="markdown"  # YAML frontmatter + markdown body
+
+# Capability Flags
+PROVIDER_HAS_SUBAGENTS=true
+PROVIDER_HAS_PARALLEL=true
+PROVIDER_HAS_TASK_TOOL=true
+PROVIDER_HAS_MCP=true
+PROVIDER_MAX_PARALLEL=10
+
+# Model Configuration (Abstract Tiers)
+PROVIDER_MODEL_PLANNING="claude-opus-4-5-20251101"
+PROVIDER_MODEL_DEVELOPMENT="claude-sonnet-4-5-20251101"
+PROVIDER_MODEL_FAST="claude-haiku-4-5-20251101"
+
+# Model Selection (for Task tool)
+PROVIDER_TASK_MODEL_PARAM="model"
+PROVIDER_TASK_MODEL_VALUES=("opus" "sonnet" "haiku")
+
+# Context and Limits
+PROVIDER_CONTEXT_WINDOW=200000
+PROVIDER_MAX_OUTPUT_TOKENS=64000
+PROVIDER_RATE_LIMIT_RPM=50
+
+# Cost (USD per 1K tokens, approximate)
+PROVIDER_COST_INPUT_PLANNING=0.015
+PROVIDER_COST_OUTPUT_PLANNING=0.075
+PROVIDER_COST_INPUT_DEV=0.003
+PROVIDER_COST_OUTPUT_DEV=0.015
+PROVIDER_COST_INPUT_FAST=0.00025
+PROVIDER_COST_OUTPUT_FAST=0.00125
+
+# Degraded Mode
+PROVIDER_DEGRADED=false
+PROVIDER_DEGRADED_REASONS=()
+
+# Detection function - check if provider CLI is available
+provider_detect() {
+    command -v claude >/dev/null 2>&1
+}
+
+# Version check function
+provider_version() {
+    claude --version 2>/dev/null | head -1
+}
+
+# Invocation function
+provider_invoke() {
+    local prompt="$1"
+    shift
+    claude --dangerously-skip-permissions -p "$prompt" "$@"
+}
+
+# Model tier to Task tool model parameter value
+provider_get_tier_param() {
+    local tier="$1"
+    case "$tier" in
+        planning) echo "opus" ;;
+        development) echo "sonnet" ;;
+        fast) echo "haiku" ;;
+        *) echo "sonnet" ;;  # default to development tier
+    esac
+}
+
+# Tier-aware invocation (Claude supports model selection via --model flag)
+provider_invoke_with_tier() {
+    local tier="$1"
+    local prompt="$2"
+    shift 2
+    local model
+    model=$(provider_get_tier_param "$tier")
+    claude --dangerously-skip-permissions --model "$model" -p "$prompt" "$@"
+}

package/providers/codex.sh

@@ -0,0 +1,130 @@
+#!/bin/bash
+# OpenAI Codex CLI Provider Configuration
+# Shell-sourceable config for loki-mode multi-provider support
+
+# Provider Functions (for external use)
+# =====================================
+# These functions provide a clean interface for external scripts:
+#   provider_detect()           - Check if CLI is installed
+#   provider_version()          - Get CLI version
+#   provider_invoke()           - Invoke with prompt (autonomous mode)
+#   provider_invoke_with_tier() - Invoke with tier-specific effort level
+#   provider_get_tier_param()   - Map tier name to effort level
+#
+# Usage:
+#   source providers/codex.sh
+#   if provider_detect; then
+#       provider_invoke "Your prompt here"
+#   fi
+#
+# Note: autonomy/run.sh uses inline invocation for streaming support
+# and real-time agent tracking. These functions are intended for
+# simpler scripts, wrappers, and external integrations.
+# =====================================
+
+# Provider Identity
+PROVIDER_NAME="codex"
+PROVIDER_DISPLAY_NAME="OpenAI Codex CLI"
+PROVIDER_CLI="codex"
+
+# CLI Invocation
+# Note: codex uses positional prompt after "exec" subcommand
+# VERIFIED: exec --dangerously-bypass-approvals-and-sandbox confirmed in codex exec --help (v0.89.0)
+# "Skip all confirmation prompts and execute commands without sandboxing. EXTREMELY DANGEROUS."
+PROVIDER_AUTONOMOUS_FLAG="exec --dangerously-bypass-approvals-and-sandbox"
+PROVIDER_PROMPT_FLAG=""
+PROVIDER_PROMPT_POSITIONAL=true
+
+# Skill System
+# Note: Codex CLI does not have a native skills system
+PROVIDER_SKILL_DIR=""
+PROVIDER_SKILL_FORMAT="none"
+
+# Capability Flags
+PROVIDER_HAS_SUBAGENTS=false
+PROVIDER_HAS_PARALLEL=false
+PROVIDER_HAS_TASK_TOOL=false
+PROVIDER_HAS_MCP=false
+PROVIDER_MAX_PARALLEL=1
+
+# Model Configuration
+# Codex uses single model with effort parameter
+# NOTE: "gpt-5.2-codex" is a PLACEHOLDER model name. Update this value when
+# official Codex CLI documentation specifies the actual model identifier.
+PROVIDER_MODEL_PLANNING="gpt-5.2-codex"
+PROVIDER_MODEL_DEVELOPMENT="gpt-5.2-codex"
+PROVIDER_MODEL_FAST="gpt-5.2-codex"
+
+# Effort levels (Codex-specific: maps to reasoning time, not model capability)
+PROVIDER_EFFORT_PLANNING="xhigh"
+PROVIDER_EFFORT_DEVELOPMENT="high"
+PROVIDER_EFFORT_FAST="low"
+
+# No Task tool - effort is set via CLI flag
+PROVIDER_TASK_MODEL_PARAM=""
+PROVIDER_TASK_MODEL_VALUES=()
+
+# Context and Limits
+PROVIDER_CONTEXT_WINDOW=128000
+PROVIDER_MAX_OUTPUT_TOKENS=32000
+PROVIDER_RATE_LIMIT_RPM=60
+
+# Cost (USD per 1K tokens, approximate for GPT-5.2)
+PROVIDER_COST_INPUT_PLANNING=0.010
+PROVIDER_COST_OUTPUT_PLANNING=0.030
+PROVIDER_COST_INPUT_DEV=0.010
+PROVIDER_COST_OUTPUT_DEV=0.030
+PROVIDER_COST_INPUT_FAST=0.010
+PROVIDER_COST_OUTPUT_FAST=0.030
+
+# Degraded Mode
+PROVIDER_DEGRADED=true
+PROVIDER_DEGRADED_REASONS=(
+    "No Task tool subagent support - cannot spawn parallel agents"
+    "Single model with effort parameter - no cheap tier for parallelization"
+    "No native skills system - SKILL.md must be passed via prompt"
+    "No MCP server integration"
+)
+
+# Detection function - check if provider CLI is available
+provider_detect() {
+    command -v codex >/dev/null 2>&1
+}
+
+# Version check function
+provider_version() {
+    codex --version 2>/dev/null | head -1
+}
+
+# Invocation function
+# Note: Codex uses positional prompt, not -p flag
+# Note: Reasoning effort is configured via environment or config, not CLI flag
+provider_invoke() {
+    local prompt="$1"
+    shift
+    codex exec --dangerously-bypass-approvals-and-sandbox "$prompt" "$@"
+}
+
+# Model tier to effort level parameter (Codex uses effort, not separate models)
+provider_get_tier_param() {
+    local tier="$1"
+    case "$tier" in
+        planning) echo "xhigh" ;;
+        development) echo "high" ;;
+        fast) echo "low" ;;
+        *) echo "high" ;;  # default to development tier
+    esac
+}
+
+# Tier-aware invocation
+# Note: Codex CLI does not support effort CLI flags
+# Effort must be configured via environment: CODEX_MODEL_REASONING_EFFORT
+# This function sets the env var before invocation
+provider_invoke_with_tier() {
+    local tier="$1"
+    local prompt="$2"
+    shift 2
+    local effort
+    effort=$(provider_get_tier_param "$tier")
+    CODEX_MODEL_REASONING_EFFORT="$effort" codex exec --dangerously-bypass-approvals-and-sandbox "$prompt" "$@"
+}

package/providers/gemini.sh

@@ -0,0 +1,131 @@
+#!/bin/bash
+# Google Gemini CLI Provider Configuration
+# Shell-sourceable config for loki-mode multi-provider support
+
+# Provider Functions (for external use)
+# =====================================
+# These functions provide a clean interface for external scripts:
+#   provider_detect()           - Check if CLI is installed
+#   provider_version()          - Get CLI version
+#   provider_invoke()           - Invoke with prompt (autonomous mode)
+#   provider_invoke_with_tier() - Invoke with tier-specific thinking level
+#   provider_get_tier_param()   - Map tier name to thinking level
+#
+# Usage:
+#   source providers/gemini.sh
+#   if provider_detect; then
+#       provider_invoke "Your prompt here"
+#   fi
+#
+# Note: autonomy/run.sh uses inline invocation for streaming support
+# and real-time agent tracking. These functions are intended for
+# simpler scripts, wrappers, and external integrations.
+# =====================================
+
+# Provider Identity
+PROVIDER_NAME="gemini"
+PROVIDER_DISPLAY_NAME="Google Gemini CLI"
+PROVIDER_CLI="gemini"
+
+# CLI Invocation
+# VERIFIED: --yolo flag confirmed in gemini --help (v0.25.2)
+# "Automatically accept all actions (aka YOLO mode)"
+PROVIDER_AUTONOMOUS_FLAG="--yolo"
+# NOTE: -p flag is DEPRECATED per gemini --help. Using positional prompt instead.
+PROVIDER_PROMPT_FLAG=""
+PROVIDER_PROMPT_POSITIONAL=true
+
+# Skill System
+# Note: Gemini CLI does not have a native skills system
+PROVIDER_SKILL_DIR=""
+PROVIDER_SKILL_FORMAT="none"
+
+# Capability Flags
+PROVIDER_HAS_SUBAGENTS=false
+PROVIDER_HAS_PARALLEL=false
+PROVIDER_HAS_TASK_TOOL=false
+PROVIDER_HAS_MCP=false
+PROVIDER_MAX_PARALLEL=1
+
+# Model Configuration
+# Gemini uses single model with thinking_level parameter
+# NOTE: "gemini-3-pro-medium" is a PLACEHOLDER model name. Update this value when
+# official Gemini CLI documentation specifies the actual model identifier.
+PROVIDER_MODEL_PLANNING="gemini-3-pro-medium"
+PROVIDER_MODEL_DEVELOPMENT="gemini-3-pro-medium"
+PROVIDER_MODEL_FAST="gemini-3-pro-medium"
+
+# Thinking levels (Gemini-specific: maps to reasoning depth)
+PROVIDER_THINKING_PLANNING="high"
+PROVIDER_THINKING_DEVELOPMENT="medium"
+PROVIDER_THINKING_FAST="low"
+
+# No Task tool - thinking level is set via CLI flag
+PROVIDER_TASK_MODEL_PARAM=""
+PROVIDER_TASK_MODEL_VALUES=()
+
+# Context and Limits
+PROVIDER_CONTEXT_WINDOW=1000000  # Gemini 3 has 1M context
+PROVIDER_MAX_OUTPUT_TOKENS=65536
+PROVIDER_RATE_LIMIT_RPM=60
+
+# Cost (USD per 1K tokens, approximate for Gemini 3 Pro)
+PROVIDER_COST_INPUT_PLANNING=0.00125
+PROVIDER_COST_OUTPUT_PLANNING=0.005
+PROVIDER_COST_INPUT_DEV=0.00125
+PROVIDER_COST_OUTPUT_DEV=0.005
+PROVIDER_COST_INPUT_FAST=0.00125
+PROVIDER_COST_OUTPUT_FAST=0.005
+
+# Degraded Mode
+PROVIDER_DEGRADED=true
+PROVIDER_DEGRADED_REASONS=(
+    "No Task tool subagent support - cannot spawn parallel agents"
+    "Single model with thinking_level parameter - no cheap tier for parallelization"
+    "No native skills system - SKILL.md must be passed via prompt"
+    "No MCP server integration"
+)
+
+# Detection function - check if provider CLI is available
+provider_detect() {
+    command -v gemini >/dev/null 2>&1
+}
+
+# Version check function
+provider_version() {
+    gemini --version 2>/dev/null | head -1
+}
+
+# Invocation function
+# Note: Gemini CLI does not support thinking-level CLI flags
+# Thinking mode is configured via settings.json, not CLI
+# Using positional prompt (not deprecated -p flag)
+provider_invoke() {
+    local prompt="$1"
+    shift
+    gemini --yolo "$prompt" "$@"
+}
+
+# Model tier to thinking level parameter
+provider_get_tier_param() {
+    local tier="$1"
+    case "$tier" in
+        planning) echo "high" ;;
+        development) echo "medium" ;;
+        fast) echo "low" ;;
+        *) echo "medium" ;;  # default to development tier
+    esac
+}
+
+# Tier-aware invocation
+# Note: Gemini CLI does not support thinking-level CLI flags
+# Thinking mode is configured via ~/.gemini/settings.json
+# Using positional prompt (not deprecated -p flag)
+provider_invoke_with_tier() {
+    local tier="$1"
+    local prompt="$2"
+    shift 2
+    # Log tier for debugging (thinking level must be pre-configured in settings.json)
+    echo "[loki] Using tier: $tier (configure thinking in ~/.gemini/settings.json)" >&2
+    gemini --yolo "$prompt" "$@"
+}