Skip to content

davila7/claude-code-templates / cli-tool/components/skills/ai-research/loki-mode

loki-mode

Flagged

Multi-agent autonomous startup system for Claude Code. Triggers on "Loki Mode". Orchestrates 100+ specialized agents across engineering, QA, DevOps, security, data/ML, business operations, marketing, HR, and customer success. Takes PRD to fully deployed, revenue-generating product with zero human intervention. Features Task tool for subagent dispatch, parallel code review with 3 specialized reviewers, severity-based issue triage, distributed task queue with dead letter handling, automatic deployment to cloud providers, A/B testing, customer feedback loops, incident response, circuit breakers, and self-healing. Handles rate limits via distributed state checkpoints and auto-resume with exponential backoff. Requires --dangerously-skip-permissions flag.

FileKindSize
.github/workflows/claude-code-review.ymlconfig1.9 KB
.github/workflows/claude.ymlconfig1.8 KB
.github/workflows/release.ymlconfig4.8 KB
.gitignoreother10 B
ACKNOWLEDGEMENTS.mdmarkdown11.8 KB
CHANGELOG.mdmarkdown83.9 KB
CLAUDE.mdmarkdown4.3 KB
CONTEXT-EXPORT.mdmarkdown6.5 KB
INSTALLATION.mdmarkdown9.1 KB
LICENSEother1.1 KB
README.mdmarkdown18.2 KB
SKILL.mdskill md27.9 KB
VERSIONother7 B
autonomy/.loki/dashboard/index.htmlother15.2 KB
autonomy/CONSTITUTION.mdmarkdown10.2 KB
autonomy/README.mdmarkdown7.5 KB
autonomy/run.shexecutablescript74.4 KB
benchmarks/datasets/humaneval.jsonlother209.4 KB
benchmarks/datasets/swebench-lite.jsonconfig321 B
benchmarks/prepare-submission.shexecutablescript6.6 KB
benchmarks/results/2026-01-05-00-23-56/SUMMARY.mdmarkdown1.2 KB
benchmarks/results/2026-01-05-00-23-56/humaneval-results.jsonconfig365 B
benchmarks/results/2026-01-05-00-23-56/swebench-results.jsonconfig383 B
benchmarks/results/2026-01-05-00-49-17/SUMMARY.mdmarkdown1.2 KB
benchmarks/results/2026-01-05-00-49-17/humaneval-results.jsonconfig33.6 KB
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/0.pyscript528 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/1.pyscript936 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/10.pyscript758 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/100.pyscript598 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/101.pyscript537 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/102.pyscript436 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/103.pyscript519 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/104.pyscript602 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/105.pyscript1.1 KB
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/106.pyscript749 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/107.pyscript938 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/108.pyscript720 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/109.pyscript1.6 KB
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/11.pyscript443 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/110.pyscript882 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/111.pyscript859 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/112.pyscript732 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/113.pyscript853 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/114.pyscript447 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/115.pyscript1.2 KB
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/116.pyscript521 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/117.pyscript995 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/118.pyscript835 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/119.pyscript1002 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/12.pyscript564 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/120.pyscript706 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/121.pyscript339 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/122.pyscript494 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/123.pyscript1.1 KB
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/124.pyscript1.6 KB
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/125.pyscript757 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/126.pyscript943 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/127.pyscript1.5 KB
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/128.pyscript653 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/129.pyscript2.2 KB
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/13.pyscript264 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/130.pyscript940 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/131.pyscript417 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/132.pyscript1.0 KB
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/133.pyscript524 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/134.pyscript779 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/135.pyscript481 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/136.pyscript667 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/137.pyscript751 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/138.pyscript295 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/139.pyscript455 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/14.pyscript263 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/140.pyscript989 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/141.pyscript1.4 KB
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/142.pyscript822 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/143.pyscript1.0 KB
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/144.pyscript780 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/145.pyscript702 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/146.pyscript700 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/147.pyscript734 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/148.pyscript1.1 KB
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/149.pyscript880 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/15.pyscript266 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/150.pyscript371 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/151.pyscript647 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/152.pyscript845 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/153.pyscript1.4 KB
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/154.pyscript567 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/155.pyscript427 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/156.pyscript750 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/157.pyscript463 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/158.pyscript524 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/159.pyscript1.1 KB
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/16.pyscript295 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/160.pyscript968 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/161.pyscript637 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/162.pyscript337 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/163.pyscript425 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/17.pyscript736 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/18.pyscript548 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/19.pyscript714 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/2.pyscript360 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/20.pyscript835 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/21.pyscript493 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/22.pyscript349 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/23.pyscript153 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/24.pyscript260 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/25.pyscript689 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/26.pyscript406 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/27.pyscript205 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/28.pyscript240 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/29.pyscript367 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/3.pyscript590 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/30.pyscript262 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/31.pyscript525 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/32.pyscript1.5 KB
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/33.pyscript710 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/34.pyscript172 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/35.pyscript200 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/36.pyscript357 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/37.pyscript481 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/38.pyscript567 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/39.pyscript762 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/4.pyscript530 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/40.pyscript684 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/41.pyscript661 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/42.pyscript239 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/43.pyscript582 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/44.pyscript441 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/45.pyscript158 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/46.pyscript620 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/47.pyscript342 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/48.pyscript271 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/49.pyscript245 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/5.pyscript466 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/50.pyscript412 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/51.pyscript469 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/52.pyscript255 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/53.pyscript129 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/54.pyscript458 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/55.pyscript302 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/56.pyscript559 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/57.pyscript458 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/58.pyscript268 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/59.pyscript477 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/6.pyscript832 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/60.pyscript259 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/61.pyscript559 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/62.pyscript333 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/63.pyscript624 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/64.pyscript560 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/65.pyscript433 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/66.pyscript410 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/67.pyscript876 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/68.pyscript1.5 KB
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/69.pyscript709 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/7.pyscript379 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/70.pyscript693 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/71.pyscript589 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/72.pyscript837 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/73.pyscript612 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/74.pyscript779 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/75.pyscript846 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/76.pyscript571 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/77.pyscript467 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/78.pyscript1.1 KB
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/79.pyscript600 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/8.pyscript527 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/80.pyscript563 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/81.pyscript1.9 KB
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/82.pyscript580 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/83.pyscript855 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/84.pyscript556 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/85.pyscript288 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/86.pyscript660 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/87.pyscript1.1 KB
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/88.pyscript784 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/89.pyscript847 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/9.pyscript506 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/90.pyscript531 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/91.pyscript601 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/92.pyscript586 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/93.pyscript974 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/94.pyscript1.1 KB
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/95.pyscript1003 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/96.pyscript804 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/97.pyscript421 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/98.pyscript396 B
benchmarks/results/2026-01-05-00-49-17/humaneval-solutions/99.pyscript886 B
benchmarks/results/2026-01-05-01-24-17/SUMMARY.mdmarkdown1.3 KB
benchmarks/results/2026-01-05-01-24-17/swebench-patches/astropy__astropy-12907.patchother1.0 KB
benchmarks/results/2026-01-05-01-24-17/swebench-patches/astropy__astropy-14182.patchother2.3 KB
benchmarks/results/2026-01-05-01-24-17/swebench-patches/astropy__astropy-14365.patchother1.3 KB
benchmarks/results/2026-01-05-01-24-17/swebench-patches/astropy__astropy-14995.patchother1.1 KB
benchmarks/results/2026-01-05-01-24-17/swebench-patches/astropy__astropy-6938.patchother997 B
benchmarks/results/2026-01-05-01-24-17/swebench-patches/astropy__astropy-7746.patchother1.6 KB
benchmarks/results/2026-01-05-01-24-17/swebench-patches/django__django-10914.patchother3.3 KB
benchmarks/results/2026-01-05-01-24-17/swebench-patches/django__django-10924.patchother1.9 KB
benchmarks/results/2026-01-05-01-24-17/swebench-patches/django__django-11001.patchother4.3 KB
benchmarks/results/2026-01-05-01-24-17/swebench-patches/django__django-11019.patchother20.2 KB

INSTALLATION.md

View on GitHub
# Loki Mode Installation Guide

Complete installation instructions for all platforms and use cases.

---

## Table of Contents

- [Quick Install (Recommended)](#quick-install-recommended)
- [Claude Code (CLI)](#claude-code-cli)
- [Claude.ai (Web)](#claudeai-web)
- [Anthropic API Console](#anthropic-api-console)
- [Verify Installation](#verify-installation)
- [Troubleshooting](#troubleshooting)

---

## Quick Install (Recommended)

**For Claude Code users:**

```bash
# Clone to your skills directory
git clone https://github.com/asklokesh/loki-mode.git ~/.claude/skills/loki-mode
```

**Done!** Skip to [Verify Installation](#verify-installation).

---

## Claude Code (CLI)

Loki Mode can be installed for Claude Code in three ways:

### Option A: Git Clone (Recommended)

**Personal installation (available in all projects):**
```bash
git clone https://github.com/asklokesh/loki-mode.git ~/.claude/skills/loki-mode
```

**Project-specific installation:**
```bash
# Navigate to your project directory first
cd /path/to/your/project

# Clone to local skills directory
git clone https://github.com/asklokesh/loki-mode.git .claude/skills/loki-mode
```

### Option B: Download from Releases

```bash
# Navigate to skills directory
cd ~/.claude/skills

# Get latest version number
VERSION=$(curl -s https://api.github.com/repos/asklokesh/loki-mode/releases/latest | grep tag_name | cut -d'"' -f4 | tr -d 'v')

# Download and extract
curl -L -o loki-mode.zip "https://github.com/asklokesh/loki-mode/releases/download/v${VERSION}/loki-mode-claude-code-${VERSION}.zip"
unzip loki-mode.zip && rm loki-mode.zip
```

**Result:** Creates `~/.claude/skills/loki-mode/SKILL.md`

### Option C: Minimal Install (curl)

If you only want the essential files without the full repository:

```bash
# Create directory structure
mkdir -p ~/.claude/skills/loki-mode/references

# Download core skill file
curl -o ~/.claude/skills/loki-mode/SKILL.md \
  https://raw.githubusercontent.com/asklokesh/loki-mode/main/SKILL.md

# Download agent definitions
curl -o ~/.claude/skills/loki-mode/references/agents.md \
  https://raw.githubusercontent.com/asklokesh/loki-mode/main/references/agents.md

# Download deployment guides
curl -o ~/.claude/skills/loki-mode/references/deployment.md \
  https://raw.githubusercontent.com/asklokesh/loki-mode/main/references/deployment.md

# Download business operations reference
curl -o ~/.claude/skills/loki-mode/references/business-ops.md \
  https://raw.githubusercontent.com/asklokesh/loki-mode/main/references/business-ops.md
```

**Note:** This minimal install won't include examples, tests, or the autonomous runner. Use Option A or B for full functionality.

---

## Claude.ai (Web)

For using Loki Mode on the Claude.ai web interface:

### Step 1: Download the Skill Package

1. Go to [Releases](https://github.com/asklokesh/loki-mode/releases)
2. Download **either**:
   - `loki-mode-X.X.X.zip` (standard format)
   - `loki-mode-X.X.X.skill` (skill format)

   Both contain the same skill and will work.

### Step 2: Upload to Claude.ai

1. Open [Claude.ai](https://claude.ai)
2. Go to **Settings** (gear icon)
3. Navigate to **Features → Skills**
4. Click **Upload Skill**
5. Select the downloaded `.zip` or `.skill` file

**File Structure:** The Claude.ai package has `SKILL.md` at the root level as required by the web interface.

---

## Anthropic API Console

For using Loki Mode through the Anthropic API Console (console.anthropic.com):

### Step 1: Download the API Package

1. Go to [Releases](https://github.com/asklokesh/loki-mode/releases)
2. Download **`loki-mode-api-X.X.X.zip`** (note the `-api-` version)

   **Important:** The API version has a different file structure than the web version.

### Step 2: Upload to API Console

1. Go to [console.anthropic.com](https://console.anthropic.com)
2. Navigate to **Skills** section
3. Click **Upload Skill**
4. Select the downloaded `loki-mode-api-X.X.X.zip` file

**File Structure:** The API package has `SKILL.md` inside a `loki-mode/` folder as required by the API.

---

## Verify Installation

### For Claude Code (CLI)

Check that the skill file is in place:

```bash
cat ~/.claude/skills/loki-mode/SKILL.md | head -10
```

**Expected output:** Should show YAML frontmatter starting with:
```yaml
---
name: loki-mode
description: Multi-Agent Autonomous Startup System
...
---
```

### For Claude.ai (Web)

1. Start a new conversation
2. Type: `Loki Mode`
3. Claude should recognize the skill and ask for a PRD

### For API Console

1. Create a new API call with skills enabled
2. Include the skill in your request
3. The skill should be available for use

---

## File Structure

After installation, you should have this structure:

```
loki-mode/
├── SKILL.md              # Main skill file (required)
├── README.md             # Documentation
├── INSTALLATION.md       # This file
├── CHANGELOG.md          # Version history
├── VERSION               # Current version number
├── LICENSE               # MIT License
├── references/           # Agent and deployment references
│   ├── agents.md
│   ├── deployment.md
│   └── business-ops.md
├── autonomy/             # Autonomous runner (CLI only)
│   ├── run.sh
│   └── README.md
├── examples/             # Sample PRDs for testing
│   ├── simple-todo-app.md
│   ├── api-only.md
│   ├── static-landing-page.md
│   └── full-stack-demo.md
├── tests/                # Test suite (CLI only)
│   ├── run-all-tests.sh
│   ├── test-bootstrap.sh
│   └── ...
└── integrations/         # Third-party integrations
    └── vibe-kanban.md
```

**Note:** Some files/directories (autonomy, tests, examples) are only available with full installation (Options A or B).

---

## Troubleshooting

### Skill Not Found

**Problem:** Claude doesn't recognize "Loki Mode" command.

**Solutions:**
1. **Check installation path:**
   ```bash
   ls -la ~/.claude/skills/loki-mode/SKILL.md
   ```

2. **Verify YAML frontmatter:**
   ```bash
   cat ~/.claude/skills/loki-mode/SKILL.md | head -5
   ```
   Should show `name: loki-mode`

3. **Restart Claude Code:**
   ```bash
   # Exit and restart claude command
   ```

### Permission Denied

**Problem:** Cannot create directories or download files.

**Solution:**
```bash
# Ensure skills directory exists
mkdir -p ~/.claude/skills

# Check permissions
ls -la ~/.claude/
```

### Download Fails

**Problem:** curl or wget commands fail.

**Solutions:**
1. **Check internet connection**

2. **Try alternate download method:**
   ```bash
   # Use wget instead of curl
   wget -O ~/.claude/skills/loki-mode/SKILL.md \
     https://raw.githubusercontent.com/asklokesh/loki-mode/main/SKILL.md
   ```

3. **Manual download:**
   - Visit the URL in a browser
   - Save file manually to `~/.claude/skills/loki-mode/`

### Autonomous Runner Won't Start

**Problem:** `./autonomy/run.sh` gives "command not found" or permission errors.

**Solutions:**
1. **Make executable:**
   ```bash
   chmod +x autonomy/run.sh
   ```

2. **Run from repository root:**
   ```bash
   # Make sure you're in the loki-mode directory
   cd ~/.claude/skills/loki-mode
   ./autonomy/run.sh
   ```

3. **Check prerequisites:**
   ```bash
   # Ensure Claude Code is installed
   claude --version

   # Ensure Python 3 is available
   python3 --version
   ```

### References Not Loading

**Problem:** Skill loads but agent definitions or deployment guides are missing.

**Solution:**
```bash
# Ensure all reference files are present
ls -la ~/.claude/skills/loki-mode/references/

# Should show:
# agents.md
# deployment.md
# business-ops.md

# If missing, download them:
curl -o ~/.claude/skills/loki-mode/references/agents.md \
  https://raw.githubusercontent.com/asklokesh/loki-mode/main/references/agents.md
```

---

## Updating Loki Mode

### For Git Installations

```bash
cd ~/.claude/skills/loki-mode
git pull origin main
```

### For Manual Installations

1. Download the latest release
2. Extract to the same directory (overwrite existing files)
3. Or delete old installation and reinstall

### Check Current Version

```bash
cat ~/.claude/skills/loki-mode/VERSION
```

---

## Uninstalling

### Claude Code (CLI)

```bash
# Remove the skill directory
rm -rf ~/.claude/skills/loki-mode
```

### Claude.ai (Web)

1. Go to **Settings → Features → Skills**
2. Find "loki-mode" in the list
3. Click **Remove**

### API Console

1. Go to **Skills** section
2. Find "loki-mode"
3. Click **Delete**

---

## Next Steps

After installation:

1. **Quick Test:** Run a simple example
   ```bash
   ./autonomy/run.sh examples/simple-todo-app.md
   ```

2. **Read Documentation:** Check out [README.md](README.md) for usage guides

3. **Create Your First PRD:** See the Quick Start section in README

4. **Join the Community:** Report issues or contribute at [GitHub](https://github.com/asklokesh/loki-mode)

---

## Need Help?

- **Issues/Bugs:** [GitHub Issues](https://github.com/asklokesh/loki-mode/issues)
- **Discussions:** [GitHub Discussions](https://github.com/asklokesh/loki-mode/discussions)
- **Documentation:** [README.md](README.md)

---

**Happy Building!**
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall