loki-mode

一句话需求,自动生成并部署应用,多智能体协作。

loki-mode 是一个多智能体自主软件开发生命周期(SDLC)框架,旨在将需求直接转化为已部署的应用。它接受 PRD、GitHub issue、OpenAPI/JSON/YAML 规范甚至一句话简述作为输入,自动完成从规格到部署的全流程。框架内置 5 家 AI 提供商(如 Anthropic、Gemini 等)的集成,并设置 8 道质量关卡(如代码审查、测试等)来保障产出质量。它可作为 GitHub Action 使用,也能在本地运行,适合自动化开发、快速原型和持续交付场景。核心能力包括需求解析、任务拆解、代码生成、质量校验和部署集成,显著减少人工编码和协调成本。

开源 unknown 智能体
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 1068
维护状态 活跃
是否开源
定价模式 unknown

项目数据

分类智能体
开发团队asklokesh
所属国家
定价模式unknown
价格说明定价信息待确认
访问状态
是否开源
开源协议NOASSERTION
主要语言Shell
技术栈/模型ai-agents,aider,anthropic,autonomous,ci-cd,claude,cline,code-review,devops,gemini,github-action,github-issues,loki-mode,multi-agent,openai-codex,openapi,pull-request-review,sdlc,spec-driven-development
GitHub 星标★ 1068
30天Star增速
HF 下载量
上线时间2025-12-26 00:00:00
最近更新2026-09-23 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数3

使用教程

难度:入门 约 10 分钟 部署方式:命令行工具 8 步

环境要求

  • Bun(推荐,最快启动)或 Node.js/npm 环境
  • 可选:Docker(使用官方镜像方式安装时)
  • 可选:Claude Code(安装 Loki 插件时使用)
  • 安装和升级需要网络;`npx loki-mode tour` 试跑不需要网络

安装与启动步骤

  1. 1先免安装试跑

    不安装、不需要 API Key、不联网也不会产生费用,直接打印一份真实构建的 Evidence Receipt。

    npx loki-mode tour
  2. 2安装 loki-mode

    官方推荐用 Bun 全局安装,得到 loki CLI。

    bun install -g loki-mode
  3. 3换用 npm 安装

    没有 Bun 也可以走 npm 安装,会自动回退到 bash 实现;随时可迁移。

    npm install -g loki-mode
  4. 4或用 Homebrew

    Homebrew 安装会自动把 Bun 作为依赖装上。

    brew tap asklokesh/tap && brew install loki-mode
  5. 5或拉取 Docker 镜像

    镜像里已预装 Bun 和 Claude CLI,适合容器化环境。

    docker pull asklokesh/loki-mode:latest
  6. 6升级到最新版

    后续升级只需执行一条命令;也可用 `loki self-update --to bun` 从 npm 迁移到 Bun。

    loki self-update
  7. 7生成配置文件模板

    生成一份起步用的配置,便于了解可填写的字段。

    loki config example
  8. 8按配置启动

    把配置文件传给 loki start,格式由扩展名或内容自动识别。

    loki start --config ./loki.yaml

关键配置

配置项必填说明示例
--config给 loki start 指定配置文件路径./loki.yaml
LOKI_CONFIG_FILE用环境变量指定配置文件路径./loki.yaml
配置文件格式支持 .yaml/.yml、.json 或 .env(LOKI_*=value 每行一条)LOKI_API_KEY=${MY_KEY}
${VAR}在配置中引用环境变量,加载时展开,不要内联明文密钥${ANTHROPIC_API_KEY}

如何确认成功

执行 `npx loki-mode tour` 能打印出带 Headline 和文件数、Diff sha256 的 Evidence Receipt,即说明工具可用。

常见问题

Q:必须装 Bun 才能用吗?

A:不是。也可以 `npm install -g loki-mode`,会走 bash 回退实现;之后想迁移执行 `loki self-update --to bun` 即可。

Q:试跑会消耗 API 额度吗?

A:不会。`npx loki-mode tour` 不需要安装、不需要 API Key、不联网也不产生花费,只打印历史构建的凭据。

Q:怎么升级到新版本?

A:执行 `loki self-update`;想从 npm 切换到 Bun 安装用 `loki self-update --to bun`。

Q:Claude Code 插件装了不生效?

A:插件只是调用 CLI,不会自带 CLI,需要先安装 loki-mode;再用 `claude plugin list` 确认状态为 enabled。

Q:配置的值以哪个为准?

A:优先级为 CLI 参数 > 环境变量 > --config 文件 > 内置默认值,冲突时按此覆盖。

注意事项

  • 不要把密钥直接写进配置文件,用 `${VAR}` 引用环境变量,加载器会在读取时展开;未设置的引用会跳过并给出警告。
  • 命令行参数、环境变量、配置文件和默认值的优先级依次降低,排查问题时先看这一顺序。
  • 安装方式可随时迁移,例如 npm 换 Bun 用 `loki self-update --to bun`。
  • Docker 镜像已预装 Bun 和 Claude CLI,容器内可直接使用。

核心亮点

  • 支持多种输入格式(PRD、Issue、OpenAPI 等),降低需求描述门槛
  • 内置 8 道质量关卡,自动执行代码审查和测试,提升交付可靠性
  • 集成 5 家主流 AI 提供商,灵活切换模型,避免供应商锁定

不足之处

  • 依赖 AI 生成代码,复杂业务逻辑下可能产生错误或需人工干预
  • 文档/社区待观察

适用场景

  • 快速从 PRD 或 Issue 生成 MVP 并部署到云环境
  • 在 CI/CD 流水线中自动完成代码审查和基础测试
  • 团队用自然语言描述需求,自动生成可运行的后端服务

替代项目

GPT Engineer、Aider、MetaGPT

项目介绍

loki-mode 是智能体领域的开源项目,由 asklokesh 开发,2025 年首次发布。

在全站 13,014 个收录项目中,它的 GitHub 星标数(1,068)位列前 30%,在智能体分类中处于中上游。

近 45 天,它的 GitHub 星标从 1,032 增加到 1,068,净增 36。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-23。从国内网络环境看,可直接访问。

它主要面向的使用场景是:快速从PRD或Issue生成MVP并部署到云环境。同类可对比的替代方案包括 GPT Engineer、Aider、MetaGPT。

上一篇:rustchain-bounties

下一篇:alook

同类项目推荐

xinchao-dynamic-mind 开源

给 AI 装上疲惫和欲望,让交互更真实

独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。

★ 195 2026-08-09
deepseek-harness 开源

把 AI 能力拆成乐高积木,拼出你的专属智能体。

DeepSeek Harness: Everything is a Plugin.

★ 233327 2026-08-15
AutoGPT 开源

开箱即用的 AI 员工,交代任务就自己干完

AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mis···

★ 187492 2026-08-09
EvoAgentX 开源

让 AI 智能体自己迭代变强,越用越聪明

EvoAgentX: Building a Self-Evolving Ecosystem of AI Agents

★ 3351 2026-09-12