asklokesh/loki-mode

Loki Mode

支持Claude Code、OpenAI Codex CLI和Google Gemini CLI的多智能体自主开发系统

将产品需求文档(PRD)转化为完全部署的生产就绪产品，只需最少的人工干预。基于OpenAI、Google DeepMind和Anthropic 2025年的研究成果构建。

快速开始

bash
# 拉取最新镜像
docker pull asklokesh/loki-mode:latest

# 显示帮助信息
docker run --rm asklokesh/loki-mode

# 使用PRD启动自主模式
docker run -it \
  -e ANTHROPIC_API_KEY="$ANTHROPIC_API_KEY" \
  -v $(pwd):/workspace \
  asklokesh/loki-mode start prd.md

# 带仪表板UI的模式
docker run -it \
  -e ANTHROPIC_API_KEY="$ANTHROPIC_API_KEY" \
  -p 57374:57374 \
  -v $(pwd):/workspace \
  asklokesh/loki-mode start --api prd.md
# 仪表板地址: http://localhost:57374

镜像详情

使用示例

bash
# 交互式shell
docker run -it -v $(pwd):/workspace asklokesh/loki-mode bash

# 后台自主模式
docker run -d \
  -e ANTHROPIC_API_KEY="$ANTHROPIC_API_KEY" \
  -v $(pwd):/workspace \
  asklokesh/loki-mode start --bg prd.md

# 快速单任务模式（最多3次迭代）
docker run -it \
  -e ANTHROPIC_API_KEY="$ANTHROPIC_API_KEY" \
  -v $(pwd):/workspace \
  asklokesh/loki-mode quick "添加登录页面"

# 检查状态
docker run -it -v $(pwd):/workspace asklokesh/loki-mode status

# 从模板交互式构建PRD
docker run -it -v $(pwd):/workspace asklokesh/loki-mode init

# 从GitHub issue生成PRD
docker run -it \
  -e GITHUB_TOKEN="$GITHUB_TOKEN" \
  -v $(pwd):/workspace \
  asklokesh/loki-mode issue https://github.com/org/repo/issues/42

多提供商支持

bash
# Claude（默认）-- 完整功能支持
docker run -it \
  -e ANTHROPIC_API_KEY="$ANTHROPIC_API_KEY" \
  -v $(pwd):/workspace \
  asklokesh/loki-mode start prd.md

# OpenAI Codex CLI -- 简化模式（仅支持顺序执行）
docker run -it \
  -e LOKI_PROVIDER=codex \
  -e OPENAI_API_KEY="$OPENAI_API_KEY" \
  -v $(pwd):/workspace \
  asklokesh/loki-mode start prd.md

# Google Gemini CLI -- 简化模式（仅支持顺序执行）
docker run -it \
  -e LOKI_PROVIDER=gemini \
  -e GOOGLE_API_KEY="$GOOGLE_API_KEY" \
  -v $(pwd):/workspace \
  asklokesh/loki-mode start prd.md

卷挂载

bash
# 带Git和GitHub访问的完整设置
docker run -it \
  -e ANTHROPIC_API_KEY="$ANTHROPIC_API_KEY" \
  -e GITHUB_TOKEN="$GITHUB_TOKEN" \
  -v $(pwd):/workspace \
  -v ~/.gitconfig:/home/loki/.gitconfig:ro \
  -v ~/.ssh:/home/loki/.ssh:ro \
  -v ~/.config/gh:/home/loki/.config/gh:ro \
  -p 57374:57374 \
  asklokesh/loki-mode start --api prd.md

SSH注意事项：优先使用SSH代理转发，而非挂载私钥。尽可能只挂载known_hosts和公钥。

环境变量

凭证

核心配置

执行控制

安全（企业版）

SDLC阶段（默认全部启用，设为false可跳过）

LOKI_PHASE_UNIT_TESTS（单元测试）、LOKI_PHASE_API_TESTS（API测试）、LOKI_PHASE_E2E_TESTS（端到端测试）、LOKI_PHASE_SECURITY（安全测试）、LOKI_PHASE_INTEGRATION（集成测试）、LOKI_PHASE_CODE_REVIEW（代码审查）、LOKI_PHASE_WEB_RESEARCH（网络研究）、LOKI_PHASE_PERFORMANCE（性能测试）、LOKI_PHASE_ACCESSIBILITY（可访问性测试）、LOKI_PHASE_REGRESSION（回归测试）、LOKI_PHASE_UAT（用户验收测试）

完成委员会

TLS/HTTPS（仪表板）

CLI命令

启动选项

--provider NAME     AI提供商：claude（默认）、codex、gemini
--parallel          启用git工作树并行模式
--bg, --background  在后台运行
--simple            强制使用简单复杂度层级
--complex           强制使用复杂复杂度层级
--github            启用GitHub issue导入
--no-dashboard      禁用Web仪表板
--sandbox           在Docker沙箱中运行
--skip-memory       跳过加载内存上下文
--budget USD        设置成本预算限制
--yes, -y           跳过确认提示

Docker Compose

yaml
services:
  loki:
    image: asklokesh/loki-mode:latest
    volumes:
      - .:/workspace:rw
      - ~/.gitconfig:/home/loki/.gitconfig:ro
      - ~/.ssh:/home/loki/.ssh:ro
      - ~/.config/gh:/home/loki/.config/gh:ro
    environment:
      - ANTHROPIC_API_KEY
      - GITHUB_TOKEN
      - LOKI_DASHBOARD=true
    ports:
      - "57374:57374"
    working_dir: /workspace
    stdin_open: true
    tty: true

bash
docker compose run loki start prd.md

安全强化沙箱

适用于不受信任的PRD、企业环境或CI/CD环境：

bash
# 构建沙箱镜像
docker build -t loki-mode:sandbox -f Dockerfile.sandbox .

# 使用资源限制和安全控制运行
docker run -it \
  --cpus=2 --memory=4g --pids-limit=256 \
  --security-opt=no-new-privileges:true \
  --cap-drop=ALL --cap-add=CHOWN \
  -e ANTHROPIC_API_KEY="$ANTHROPIC_API_KEY" \
  -v $(pwd):/workspace \
  loki-mode:sandbox start prd.md

# 或使用内置沙箱启动器
./autonomy/sandbox.sh start prd.md

沙箱特性：seccomp配置文件、能力删除、资源限制、网络隔离、可选只读工作区。

健康检查

镜像包含内置健康检查，验证loki version是否正常响应。使用以下命令检查容器健康状态：

bash
docker inspect --format='{{.State.Health.Status}}' <container-id>

标签

链接

• https://github.com/asklokesh/loki-mode
• https://github.com/asklokesh/loki-mode/blob/main/docs/INSTALLATION.md
• https://asklokesh.github.io/loki-mode
• https://github.com/asklokesh/loki-mode/tree/main/templates

许可证

MIT许可证 - 参见https://github.com/asklokesh/loki-mode/blob/main/LICENSE

支持

• https://github.com/asklokesh/loki-mode/issues
• https://github.com/asklokesh/loki-mode/wiki