Loki Mode

构建未来，只争朝夕。

描述您的需求，获取生产级代码。

网站 | 文档 | 安装指南 | 更新日志 | Purple Lab Web UI

---

工作原理： 提交一份规范说明——可以是 PRD、GitHub Issue、OpenAPI/JSON/YAML 文件或是一行简短的需求描述。Loki Mode 会对复杂度进行分类（run.sh:detect_complexity()），从 8 个集群的 41 种专业代理中组建一个智能体团队，并运行自主的 RARV 循环（推理 - 执行 - 反思 - 验证，详见 run.sh:run_autonomous()），同时应用 11 个质量关卡（详见 skills/quality-gates.md）。只有通过自动化验证，代码才算“完成”。输出成果是一个包含源代码、测试、配置和审计日志的 Git 仓库。

---

为什么选择 Loki Mode？

• 从规范到产品，全程自动化 —— 描述需求后即可放手，回来时即可获得带有测试的可运行代码。Loki 会运行完整的 RARV-C 闭环（推理 - 执行 - 反思 - 验证 - 闭环），直到任务真正完成，而不仅仅是尝试。
• 内置生产级质量 —— 包含 11 个质量关卡（skills/quality-gates.md）、盲测 3 人代码审查（run.sh:run_code_review()）以及反拍马屁（anti-sycophancy）检查。
• 跨项目记忆 —— 利用向量搜索实现情景/语义/程序化记忆；在一个项目中学到的知识可在下一个项目中复用（v5.15.0+，详见 memory/engine.py）。
• 自托管与隐私保护 —— 使用您自己的密钥和基础设施，数据绝不离开您的网络。
• 遗留系统修复 —— loki heal 包含考古/稳定化/隔离/现代化/验证阶段（v6.67.0，详见 skills/healing.md）。
• MCP 服务器 —— 提供 15 种工具，包括 ChromaDB 代码搜索（mcp/server.py）。
• 全栈输出 —— 包括源代码、测试、Docker 配置、CI/CD 流水线和审计日志。
• Provider 无关 —— 可在 Claude、Codex、Cline 或 Aider 上运行，支持自动故障转移（loki-ts/src/runner/providers.ts），无供应商锁定。Gemini CLI 已在 v7.5.18 中弃用；Antigravity CLI 即将推出。
• 开源 —— 对个人、内部及学术用途免费。

---

30 秒快速上手

先决条件

Loki 通过编码代理 CLI 驱动并协调实际构建，因此需要 PATH 中存在一些工具。loki doctor 会检查所有依赖项并告知缺少的项目。

必要组件：

• 代理 Provider CLI（至少一个）：Claude Code（claude，Tier 1，推荐），或 OpenAI Codex CLI（codex）、Cline、Aider。
• Python 3.10+（python3）：用于仪表板、记忆系统和协调辅助工具。
• Git 2.x（git）：用于检查点和工作树管理。
• curl：用于安装和网络调用。

推荐组件：

• Bun 1.3.0+（bun）：用于快速运行时（下方推荐的安装路径会安装此项）。
• Node.js 18+ 和 npm：如果您通过 npm 而非 Bun 安装。
• jq：用于在 shell 流程中更好地处理 JSON。
• Docker：如果您希望 Loki 的 App Runner 运行容器化项目，或者直接从发布镜像运行 Loki。

您还需要所选 Provider 的凭证（对于 Claude Code，需已认证的 claude 登录或 ANTHROPIC_API_KEY）。

推荐方式（Bun，最快）：

# 安装 Bun（如已安装可跳过）
curl -fsSL https://bun.sh/install | bash      # macOS / Linux
# 或: brew install oven-sh/bun/bun

bun install -g loki-mode
loki doctor                                   # 验证环境
loki init my-app --template simple-todo-app
cd my-app
loki start prd.md                             # 从 Markdown PRD 自主构建
loki start owner/repo#123                     # ...或从 GitHub issue
loki start ./openapi.yaml                     # ...或从 OpenAPI/YAML 规范

或者直接跳过脚手架，直接执行快速任务：

loki quick "build a landing page with a signup form"

其他安装方法（均可正常工作）：

方法	命令	备注
Bun (推荐)	bun install -g loki-mode	最快。v8 将仅支持 Bun。
Homebrew	brew tap asklokesh/tap && brew install loki-mode	自动安装 Bun 作为依赖
Docker	docker pull asklokesh/loki-mode:7.7.31 && docker run --rm asklokesh/loki-mode:7.7.31 start prd.md	-