convez.ai
AgenteDevOps & InfraestruturaIntermediário
CodeHawaii

OmniAgent

CodeHawaii/omniagent

6 agentes de IA para código em um container Docker, zero credenciais pré-instaladas

Ver no GitHub
InicialPluginScore · de 0 a 100

Imagem Docker multi-arquitetura com 6 agentes CLI populares pré-instalados (Claude Code, Codex, GitHub Copilot, Aider, Goose, Crush) em um único container. Construída sobre a stack omnidev com Python, Go, Node, C/C++ e sandbox hardened, sem incluir chaves de API — credenciais fornecidas em runtime.

Instalação

$npx convez-ai CodeHawaii/omniagent

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
50%
Último commit
há 5 meses
Versão
v0.0.2
Issues abertas
0
Contribuidores
1

Casos de uso

  • Executar múltiplos agentes de IA para codificação em CI/CD
  • Ambiente isolado e reproduzível para desenvolvimento assistido por IA
  • Testar e comparar diferentes agentes CLI (Claude, OpenAI, GitHub Copilot, etc)

Veredito

Solução madura e bem pensada para orquestração de agentes de código em containerização. A decisão de não incluir credenciais e suportar multi-arquitetura reflete design seguro; entretanto, a demanda por manutenção constante (evolução dos agentes upstream) pode requerer updates frequentes.

README

A tradução para o português deste README ainda está na fila.

omniagent

publish GHCR license

Popular CLI coding agents, pre-installed on top of the omnidev toolbox image. One container with Claude Code, OpenAI Codex, GitHub Copilot, Aider, Goose and Crush — plus the full omnidev stack (Python/uv, Go, Node, C/C++, git, the hardened sandbox-run.sh).

docker pull ghcr.io/codehawaii/omniagent:latest

The image ships the CLIs, never any API keys. Provide credentials at runtime (env vars or a mounted config dir). See Authentication.

  • Base: ghcr.io/codehawaii/omnidev (Debian trixie, non-root dev, multi-arch)
  • Arches: linux/amd64, linux/arm64
  • Run agents inside the container to list what's installed and which keys are detected.

Agents

AgentCommandVendorInstallAuth (headless)
Claude CodeclaudeAnthropicnpm @anthropic-ai/claude-codeANTHROPIC_API_KEY · claude -p
OpenAI CodexcodexOpenAInpm @openai/codexOPENAI_API_KEY · codex exec
GitHub CopilotcopilotGitHubnpm @github/copilotGITHUB_TOKEN (Copilot-enabled)
Aideraideropen sourceuv (Python 3.12) aider-chatany provider key (BYO)
GoosegooseBlock / Linux Foundationofficial release binarymulti-provider
CrushcrushCharmofficial release binary15+ providers

All six run headless and ship on both amd64 and arm64. Current resolved versions are recorded in .versions.

Not included on purpose: Gemini CLI (Google is deprecating it 2026-06-18), OpenCode (archived → became Crush), Continue CLI (archived), Cursor CLI (proprietary, closed-source). Cline is omitted to keep the image lean (its CLI bundles ~0.8GB of vendored binaries).


Authentication

The image contains no credentials. Supply them at runtime, two ways:

1) Environment variables (best for CI/automation):

docker run --rm -it \
  -e ANTHROPIC_API_KEY -e OPENAI_API_KEY \
  -v "$PWD":/work -w /work \
  ghcr.io/codehawaii/omniagent claude

2) Mounted config (best for local use — log in once on the host, reuse it):

docker run --rm -it \
  -v ~/.claude:/home/dev/.claude:ro \
  -v ~/.codex:/home/dev/.codex:ro \
  -v "$PWD":/work -w /work \
  ghcr.io/codehawaii/omniagent codex

Mount auth dirs read-only (:ro) so a misbehaving agent can't corrupt or exfiltrate your tokens. agents prints which keys/config it sees.


Trust model — agents run code

These agents edit files and execute commands. Two modes:

  Trusted repo (normal)                 Untrusted code (audit / review)
  ───────────────────────               ────────────────────────────────
  your own project; agent               wrap the agent in omnidev's
  edits + runs with network             sandbox-run.sh: read-only rootfs,
  to reach the model API.               caps dropped, resource limits.
  `claude`, `codex exec`, ...           `sandbox-run.sh --net <repo> 'aider ...'`
  • For your own code, run the agent directly (it needs network for the LLM API).
  • For untrusted third-party code, wrap it with the inherited sandbox-run.sh for defense-in-depth.
  • Auto-approve flags (--dangerously-skip-permissions, Codex --sandbox workspace-write, etc.) are convenient but should only be used on code you trust. The container is process isolation; the sandbox adds a second line of defense.

Quick start

# What's installed + which keys are set
docker run --rm ghcr.io/codehawaii/omniagent agents

# Claude Code, headless, on the current repo
docker run --rm -e ANTHROPIC_API_KEY -v "$PWD":/work -w /work \
  ghcr.io/codehawaii/omniagent claude -p "summarize this codebase"

# Codex, non-interactive
docker run --rm -e OPENAI_API_KEY -v "$PWD":/work -w /work \
  ghcr.io/codehawaii/omniagent codex exec "add a test for utils.parse()"

# Aider on a git repo
docker run --rm -e ANTHROPIC_API_KEY -v "$PWD":/work -w /work \
  ghcr.io/codehawaii/omniagent aider --yes-always

Updating — upgrade all agents, cut a new image

The published image always builds the latest of each agent (Dockerfile ARGs default to latest), so any rebuild upgrades them all.

./update-agents.sh          # refresh ./.versions with current latest (BOM)
make update                 # same

gh workflow run publish.yml # manual rebuild → ghcr.io/.../omniagent:edge,:latest
git tag v$(date -u +%Y.%m.%d) && git push --tags   # a dated, versioned release
make release                # shortcut for the tag + push above

CI also rebuilds automatically every Monday (schedule cron in publish.yml), so agents stay current without manual action. Pin a specific agent at build time with e.g. --build-arg CLAUDE_CODE_VERSION=2.1.177.


Build & publish

make build    # builds on omnidev:local -> omniagent:local
make agents   # print bundled agents + versions
make run      # build + interactive shell

publish.yml builds multi-arch and pushes to GHCR on push to main, v* tags, manual dispatch, and the weekly schedule, with SLSA provenance + SBOM. PRs build amd64 and smoke-test only (pr-build.yml).

The image builds FROM ghcr.io/codehawaii/omnidev — that base package must be public (or readable by this repo) for CI to pull it. Making the GHCR package public is a one-time, irreversible step in the org package settings.


License

MIT — see LICENSE. Bundled agents retain their own licenses (Apache-2.0, MIT, FSL-1.1-MIT for Crush, etc.).

Ver o original no GitHub

Bom para

Relacionados