Sign inSign up

micrograils/opencode-ultra

By micrograils

Updated about 22 hours ago

开箱即用的 AI 开发环境,整合三大核心组件:OpenCode + Impetus + oh-my-openagent。

Image
Developer tools
0

2.3K

micrograils/opencode-ultra repository overview

Docker Image Size Docker Pulls Platforms

micrograils/opencode-ultra

开箱即用的 AI 编程开发环境:OpenCode + Impetus + oh-my-openagent 一体化,一条命令启动,直接开写。

快速开始(30 秒)

# 1. 直接在当前路径开始
docker run --rm -it -v $(pwd):/workspace \
  micrograils/opencode-ultra

# 2. 或者使用自有 ANTHROPIC_API_KEY 
docker run -it --rm -v $(pwd):/workspace \
  -e ANTHROPIC_API_KEY=你的API密钥 \
  micrograils/opencode-ultra

# 3. 容器内开始用
opencode                 # 启动 AI 编程助手

没有 API Key 也能先进容器熟悉环境,模型配置见下方「环境变量」。

开箱福利:opencode-here 一键脚本

镜像里自带一个给宿主机用的小脚本 opencode-here:以后在任何项目目录敲一下,容器自动开好(容器名取自目录名,同一目录可复用、可重建)。

# 一次性取出到宿主机(任意位置执行,建议放到 ~/bin 下)
docker create --name ocu-tmp micrograils/opencode-ultra
docker cp ocu-tmp:/usr/local/bin/opencode-here ~/bin/opencode-here
docker rm ocu-tmp

# 以后进入某个项目目录:
cd ~/my-project
opencode-here          # 后台启动;再次运行可复用/重建该容器
opencode-here --rm     # 前台启动,退出即自动删除
docker exec -it opencode-my-project bash   # 随时再进容器

Docker Compose(推荐)

services:
  opencode-ultra:
    image: micrograils/opencode-ultra:latest
    container_name: opencode-ultra
    stdin_open: true
    tty: true
    environment:
      - ANTHROPIC_API_KEY=your-api-key
    volumes:
      - ./project:/workspace
docker compose up -d
docker attach opencode-ultra

环境变量

变量说明
ANTHROPIC_API_KEYAnthropic (Claude) API 密钥
OPENAI_API_KEYOpenAI (GPT) API 密钥
GEMINI_API_KEYGoogle (Gemini) API 密钥
GITHUB_TOKENGitHub Copilot Token
OPENCODE_ULTRA_UID / OPENCODE_ULTRA_GID固定容器内运行时 uid/gid(默认自动跟随 /workspace 属主)

下面是有空再看的细节。

工作目录与权限

  • -v $(pwd):/workspace 把宿主目录挂进容器,两侧改动即时同步
  • 容器自动以 /workspace 的属主运行:root 宿主即以 root 跑、uid 1000 宿主即以 node 跑,其余 uid 自动适配。因此容器内写出的文件在宿主机上属主一致,无需手动 chown
  • 强制指定运行时用户:用 docker run --user 1000:1000 ...,或用上面的 OPENCODE_ULTRA_UID/GID 环境变量。
  • 若启动时报 /workspace 不可写(例如用了 --user 绕过自动适配),在宿主机执行:cd <项目目录> && sudo chown -R $(id -u):$(id -g) .

组件一览

组件说明
OpenCode开源 AI 编程助手,支持 Claude/GPT/Gemini 等 75+ 模型
ImpetusOpenSpec + Superpowers 工作流,结构化开发流程(brainstorming → design → build → verify → archive)
oh-my-openagent多 agent 编排插件,11 个专业 agent、Team Mode、MCP 工具链、54+ 生命周期钩子

常用命令

Impetus 工作流
命令说明
/impetus "想法"启动完整工作流
/impetus-open阶段 1:开启
/impetus-design阶段 2:深度设计
/impetus-build阶段 3:计划与构建
/impetus-verify阶段 4:验证与收尾
/impetus-archive阶段 5:归档
/impetus-hotfix快速 Bug 修复
/impetus-tweak小改动
oh-my-openagent
命令说明
ultrawork / ulw一键激活所有 agent,全自动执行
/init-deep生成层级 AGENTS.md
/start-workPrometheus 规划模式
/ulw-loop持久化多目标循环

多模型协作

oh-my-openagent 内置 11 个专业 Agent,自动分工协作:

Agent职责
Sisyphus主编排者,计划与委派
Hephaestus深度执行者,端到端实现
Oracle代码审查与质量把关
Librarian文档与知识检索
Prometheus战略规划,面试式需求分析
Explore代码库探索与理解

镜像信息

  • 基础镜像:node:22-slim (Debian)
  • 工作目录:/workspace
  • 多架构:amd64 / arm64
  • 许可证:OpenCode (MIT), Impetus (MIT), oh-my-openagent (SUL-1.0)

维护者文档(构建 / 版本管理 / 升级 / 维护)见 MAINTENANCE.md

Tag summary

Content type

Image

Digest

sha256:d92b87d7c

Size

718.3 MB

Last updated

about 22 hours ago

docker pull micrograils/opencode-ultra