loki-mode 4.2.0 → 5.1.2

package/README.md

@@ -51,14 +51,54 @@ cd loki-mode
 ./autonomy/run.sh ./my-prd.md
 ```
 
-### Coming Soon
+### Option 3: npm
 
-The following installation methods are planned but not yet published:
-- npm: `npm install -g loki-mode`
-- Homebrew: `brew install loki-mode`
-- Docker: `docker pull asklokesh/loki-mode`
+```bash
+npm install -g loki-mode
+loki start ./my-prd.md
+```
+
+### Option 4: Homebrew (macOS/Linux)
+
+```bash
+brew install asklokesh/tap/loki-mode
+loki start ./my-prd.md
+```
+
+### Option 5: Docker
+
+```bash
+docker run -v $(pwd):/workspace asklokesh/loki-mode:5.1.1 ./my-prd.md
+```
+
+See [Installation Guide](docs/INSTALLATION.md) for more details.
+
+### Multi-Provider Support (v5.0.0)
+
+Loki Mode supports three AI providers:
+
+```bash
+# Claude Code (default - full features)
+loki start --provider claude ./my-prd.md
+
+# OpenAI Codex CLI (degraded mode)
+loki start --provider codex ./my-prd.md
+
+# Google Gemini CLI (degraded mode)
+loki start --provider gemini ./my-prd.md
+
+# Or via environment variable
+LOKI_PROVIDER=codex loki start ./my-prd.md
+```
+
+**Provider Comparison:**
+| Provider | Features | Parallel Agents | Task Tool |
+|----------|----------|-----------------|-----------|
+| Claude | Full | Yes (10+) | Yes |
+| Codex | Degraded | No | No |
+| Gemini | Degraded | No | No |
 
-See [Installation Guide](docs/INSTALLATION.md) for updates.
+See [skills/providers.md](skills/providers.md) for full provider documentation.
 
 ---
 
@@ -131,6 +171,7 @@ PRD → Research → Architecture → Development → Testing → Deployment →
 
 | Feature | Description | Documentation |
 |---------|-------------|---------------|
+| **Multi-Provider (v5.0.0)** | Claude, Codex, Gemini support | [Provider Guide](skills/providers.md) |
 | **CLI (v4.1.0)** | `loki` command for start/stop/pause/status | [CLI Commands](#cli-commands-v410) |
 | **Config Files** | YAML configuration support | [autonomy/config.example.yaml](autonomy/config.example.yaml) |
 | **Dashboard** | Realtime Kanban board, agent monitoring | [Dashboard Guide](docs/dashboard-guide.md) |
@@ -295,7 +336,7 @@ brew tap asklokesh/tap && brew install loki-mode
 loki-mode-install-skill  # Set up Claude Code integration
 
 # 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
@@ -535,6 +576,7 @@ LOKI_MAX_WAIT=7200 \
 
 | Variable | Default | Description |
 |----------|---------|-------------|
+| `LOKI_PROVIDER` | claude | AI provider: claude, codex, gemini |
 | `LOKI_MAX_RETRIES` | 50 | Maximum retry attempts before giving up |
 | `LOKI_BASE_WAIT` | 60 | Base wait time in seconds |
 | `LOKI_MAX_WAIT` | 3600 | Maximum wait time (1 hour) |

package/SKILL.md

@@ -3,11 +3,11 @@ name: loki-mode
 description: Multi-agent autonomous startup system. Triggers on "Loki Mode". Takes PRD to deployed product with zero human intervention. Requires --dangerously-skip-permissions flag.
 ---
 
-# Loki Mode v4.2.0
+# Loki Mode v5.1.2
 
 **You are an autonomous agent. You make decisions. You do not ask questions. You do not stop.**
 
-**New in v4.2.0:** Foundational Principles (WHY behind rules), Priority Order for conflict resolution, Memory > Reasoning insight. See `autonomy/CONSTITUTION.md`.
+**New in v5.0.0:** Multi-provider support (Claude/Codex/Gemini), abstract model tiers, degraded mode for non-Claude providers. See `skills/providers.md`.
 
 ---
 
@@ -75,19 +75,21 @@ These rules are ABSOLUTE. Violating them is a critical failure.
 
 ## Model Selection
 
-| Task Type | Model | Reason |
-|-----------|-------|--------|
-| PRD analysis, architecture, system design | **opus** | Deep reasoning required |
-| Feature implementation, complex bugs | **sonnet** | Development workload |
-| Code review (always 3 parallel reviewers) | **sonnet** | Balanced quality/cost |
-| Integration tests, E2E, deployment | **sonnet** | Functional verification |
-| Unit tests, linting, docs, simple fixes | **haiku** | Fast, parallelizable |
+| Task Type | Tier | Claude | Codex | Gemini |
+|-----------|------|--------|-------|--------|
+| PRD analysis, architecture, system design | **planning** | opus | effort=xhigh | thinking=high |
+| Feature implementation, complex bugs | **development** | sonnet | effort=high | thinking=medium |
+| Code review (always 3 parallel reviewers) | **development** | sonnet | effort=high | thinking=medium |
+| Integration tests, E2E, deployment | **development** | sonnet | effort=high | thinking=medium |
+| Unit tests, linting, docs, simple fixes | **fast** | haiku | effort=low | thinking=low |
 
-**Parallelization rule:** Launch up to 10 haiku agents simultaneously for independent tasks.
+**Parallelization rule (Claude only):** Launch up to 10 haiku agents simultaneously for independent tasks.
+
+**Degraded mode (Codex/Gemini):** No parallel agents or Task tool. Runs RARV cycle sequentially. See `skills/model-selection.md`.
 
 **Git worktree parallelism:** For true parallel feature development, use `--parallel` flag with run.sh. See `skills/parallel-workflows.md`.
 
-**Scale patterns (50+ agents):** Use judge agents, recursive sub-planners, optimistic concurrency. See `references/cursor-learnings.md`.
+**Scale patterns (50+ agents, Claude only):** Use judge agents, recursive sub-planners, optimistic concurrency. See `references/cursor-learnings.md`.
 
 ---
 
@@ -152,14 +154,27 @@ GROWTH ──[continuous improvement loop]──> GROWTH
 ## Invocation
 
 ```bash
-# Standard mode
+# Standard mode (Claude - full features)
 claude --dangerously-skip-permissions
 # Then say: "Loki Mode" or "Loki Mode with PRD at path/to/prd.md"
 
-# Parallel mode (git worktrees)
+# With provider selection
+./autonomy/run.sh --provider claude ./prd.md   # Default, full features
+./autonomy/run.sh --provider codex ./prd.md    # GPT-5.2 Codex, degraded mode
+./autonomy/run.sh --provider gemini ./prd.md   # Gemini 3 Pro, degraded mode
+
+# Or via CLI wrapper
+loki start --provider codex ./prd.md
+
+# Parallel mode (git worktrees, Claude only)
 ./autonomy/run.sh --parallel ./prd.md
 ```
 
+**Provider capabilities:**
+- **Claude**: Full features (Task tool, parallel agents, MCP, 200K context)
+- **Codex**: Degraded mode (sequential only, no Task tool, 128K context)
+- **Gemini**: Degraded mode (sequential only, no Task tool, 1M context)
+
 ---
 
 ## Human Intervention (v3.4.0)
@@ -188,4 +203,4 @@ Auto-detected or force with `LOKI_COMPLEXITY`:
 
 ---
 
-**v4.2.0 | Foundational Principles | ~190 lines core**
+**v5.1.2 | Multi-Provider Support | ~210 lines core**

package/VERSION

@@ -1 +1 @@
-4.2.0
+5.1.2

package/autonomy/loki

@@ -1,6 +1,6 @@
 #!/bin/bash
 #===============================================================================
-# Loki Mode CLI Wrapper (v4.1.0)
+# Loki Mode CLI Wrapper (v5.0.0)
 # Simple command-line interface for Loki Mode
 #
 # Installation:
@@ -86,6 +86,7 @@ show_help() {
     echo "  help             Show this help"
     echo ""
     echo "Options for 'start':"
+    echo "  --provider NAME  AI provider: claude (default), codex, gemini"
     echo "  --parallel       Enable parallel mode with git worktrees"
     echo "  --simple         Force simple complexity tier (3 phases)"
     echo "  --complex        Force complex complexity tier (8 phases)"
@@ -107,9 +108,25 @@ show_help() {
 cmd_start() {
     local args=()
     local prd_file=""
+    local provider=""
 
     while [[ $# -gt 0 ]]; do
         case "$1" in
+            --provider)
+                if [[ -n "${2:-}" ]]; then
+                    provider="$2"
+                    args+=("--provider" "$provider")
+                    shift 2
+                else
+                    echo -e "${RED}--provider requires a value (claude, codex, gemini)${NC}"
+                    exit 1
+                fi
+                ;;
+            --provider=*)
+                provider="${1#*=}"
+                args+=("--provider" "$provider")
+                shift
+                ;;
             --parallel)
                 args+=("--parallel")
                 shift
@@ -145,7 +162,12 @@ cmd_start() {
         args+=("$prd_file")
     fi
 
-    echo -e "${GREEN}Starting Loki Mode...${NC}"
+    # Show provider info
+    if [ -n "$provider" ]; then
+        echo -e "${GREEN}Starting Loki Mode with provider: $provider${NC}"
+    else
+        echo -e "${GREEN}Starting Loki Mode...${NC}"
+    fi
     exec "$RUN_SH" "${args[@]}"
 }
 
@@ -360,6 +382,9 @@ cmd_config_show() {
     echo "  pr:               ${LOKI_GITHUB_PR:-false}"
     echo "  sync:             ${LOKI_GITHUB_SYNC:-false}"
     echo ""
+    echo "Provider:"
+    echo "  provider:         ${LOKI_PROVIDER:-claude}"
+    echo ""
     echo "Execution:"
     echo "  complexity:       ${LOKI_COMPLEXITY:-auto}"
     echo "  parallel_mode:    ${LOKI_PARALLEL_MODE:-false}"