O próximo sistema de harness de agentes de IA simples para código e trabalho: automático e assíncrono, com alta concorrência e desempenho, eficiente e preciso.

English | 繁體中文 | 简体中文 | 日本語 | 한국어 | Français | Deutsch | Español | Português | Русский | العربية

Instalação

Mac e Linux:

# Homebrew
brew install vcaesar/tap/codg

# NPM
# npm install -g @vcaesar/codg

Windows (PowerShell):

# Winget
# winget install vcaesar.codg

# YOLO (instalador nativo do PowerShell)
irm https://raw.githubusercontent.com/vcaesar/codg/main/demo/boot.ps1 | iex

Todos (macOS, Linux ou Windows via Git Bash / MSYS2 / Cygwin / WSL):

# YOLO
curl -fsSL https://raw.githubusercontent.com/vcaesar/codg/main/demo/boot.sh | bash

Ou clique diretamente em Releases para baixar e executar.

Entre no diretório do seu projeto, execute codg e use "/init" para inicializar o projeto. Use "/yolo" para alternar entre o modo automático e o modo de confirmação; as permissões podem ser definidas no codg.toml.

Recursos

• Sistema de agentes automático e assíncrono, com alta concorrência e desempenho, e baixo consumo de memória
• Provedores multi-modelo (40+ provedores API e Pro, Custom URL API) e modelos locais via openai-compat ou claude-compat; suporte aos modelos gratuitos do Openrouter, Ollama, Nvidia e outros; use-os via "/connect", "/models" ou "codg auth"
• Regras assíncronas e de modelo para os multi-agentes
• Compressão de entrada/saída, contexto e prompts para economizar tokens; cache e regras para reduzir o custo
• Compatível com qualquer terminal e SO, incluindo terminais web
• Fácil de usar: TUI disponível em todos os lugares, próxima de uma GUI; versões Desktop e Web em BETA
• Clique ou use "/xxx" para alternar sessões; tudo é clicável na TUI
• Clique em "Modified Files" ou use "/diff" e "/diff git" para ver arquivos de diff na TUI, como no VSCode
• Autocompletar letras e frases curtas em inglês
• Sistema de Agents, Skills e MCP mais fácil, com suporte a Agents e Skills personalizados
• Suporte a canais e funcionalidades semelhante ao OpenClaw
• Suporte completo a UI web e TUI remota
• Suporte a plugins do Claude Code/Codex

App Desktop (BETA); alguns recursos ainda aguardam testes e correções de bugs antes do lançamento.

Provedores

Atom, Copilot, Anthropic, Anthropic API, OpenAI, OpenAI API, Gemini, Gemini API, OpenRouter, Antigravity, Cursor, Kiro, xAI, Azure, Bedrock, Vertex AI, Nvidia, HuggingFace, Vercel, Ollama Cloud, Cloudflare Workers, GitHub, Poe, Meta, Groq, IO.net, OpenCode Zen, OpenCode Go, Windsurf, Cerebras.

China: Z.ai, Zhipu, Zhipu Coding, Kimi, Kimi Coding, DeepSeek, MiniMax, MiniMax China, Qwen, MiMo, Qiniu Cloud, Ali Coding, Ali Coding CN, Tencent Coding.

Benchmark

Uso de RAM

Ferramenta	1 sessão ativa	10 sessões ativas	PSS adicional por sessão adicionada
Codg	65 MB	165 MB	~10 MB
Codex CLI	140.0 MB	334.8 MB	~21.6 MB
Cursor Agent	214.9 MB	1632.4 MB	~157.5 MB
GitHub Copilot CLI	333.3 MB	1756.5 MB	~158.1 MB
OpenCode	371.5 MB	3237.2 MB	~318.4 MB
Claude Code	386.6 MB	2300.6 MB	~212.7 MB

Reportar bugs:

Abra uma Issue no Github

Como usamos seus dados:

Atualmente nenhum dado ou telemetria é coletado, e modelos 100% locais são suportados. Ao usar uma API, consulte as políticas do provedor correspondente.

Para o uso da TUI, consulte a documentação dos comandos TUI, e digite /help dentro da TUI para ver atalhos de teclado e outras ajudas.

Comandos CLI

Uso: codg -h

codg auth/login               # Autenticar (Atom, OpenAI, GitHub...)
codg web                      # Iniciar a UI web na porta 4096
codg desktop                  # Lançar o aplicativo de desktop (Wails)
codg claw                     # Iniciar o agente de mensagens (Telegram/Discord/Slack)
codg gateway --private-only   # Iniciar o gateway protegido
codg models claude            # Listar modelos que correspondam a "claude"
codg runm start Qwen/Qwen3-8B-GGUF   # Iniciar um modelo local
codg runm download user/model # Baixar um modelo GGUF
codg plugin install repo/name # Instalar um plugin
codg plugin list              # Listar os plugins instalados
codg install repo/name        # Atalho para plugin install
codg mcp add myserver cmd     # Adicionar um servidor MCP
codg mcp list                 # Listar servidores MCP configurados
codg skill url add <url>      # Adicionar uma URL de origem de skill
codg themes set catppuccin    # Trocar de tema
# codg logs -f                # Acompanhar os logs da aplicação
codg toml                     # Mostrar toda a configuração
codg stats/s                  # Mostrar estatísticas de uso
codg dirs                     # Mostrar os caminhos dos diretórios de dados/config
codg projects                 # Listar diretórios de projetos rastreados
codg lite 2                   # Definir o nível do modo lite (0-4)
codg merge origin main        # Merge git seguro com backup v1/
codg migrate                  # Migrar a configuração do .claude/.opencode
codg vm build                 # Construir em uma VM remota
codg vm run -- make test      # Executar comando na VM
codg sandbox run -- ./test.sh # Executar no sandbox
codg sandbox status           # Checar disponibilidade do sandbox
codg used                          # Exibir limites de uso e estatísticas da API de todos os provedores
codg update                   # Atualizar a versão do codg
codg updatep                  # Atualizar definições de provedores

Plugin do Claude-Code/Codex

# Codg
codg plugin marketplace add earthtojake/text-to-cad
codg plugin add cad@text-to-cad

Exemplos de uso

Não interativo (codg run)

# Canalizar entrada de outro comando.
cat errors.log | codg run "O que está causando esses erros?"
# Modo verboso (saída de depuração para stderr).
codg run -v "Debugar esta função"

UI Web

# Iniciar a UI web na porta padrão 4096.
codg web
# Porta personalizada.
codg web -p 8080

# Modo somente API (sem frontend nem navegador).
codg web 0, codg api

Gerenciamento de plugins

# Instalar um plugin a partir de um repositório Git.
codg install github.com/user/codg-xxx-auth

Agentes e skills personalizados:

Copie xx_agent.md (.codg/agents/templates) ou SKILL.md (.codg/skills) para o diretório correspondente

Sistema de configuração

Crie um codg.toml na raiz do projeto (ou ~/.codg/config/codg.toml para configurações globais):

# codg.toml — Configuração mínima do projeto.
[options]
lite_mode = 2          # 0 = todos os agentes, 2 = conjunto enxuto padrão, 4 = agente único
locale    = "en"       # Idioma da UI: en, zh-CN, ja
ctx_resize = true
token_save = 2

[options.tui]
theme     = "catppuccin"
dark_mode = true
compact_mode = false

[tools.grep]
backends = ["rg", "sg", "csearch", "ngram", "regex"]

Configuração do provedor

# Usar chave de API (suporta expansão $ENV_VAR).
[providers.anthropic]
api_key = "$ANTHROPIC_API_KEY"

# Usar OAuth (configurado via `codg auth`).
[providers.openai]
oauth = true

# Provedor personalizado / auto-hospedado.
[providers.local]
name     = "My Local LLM"
type     = "openai-compat"
base_url = "http://localhost:8080/v1"
api_key  = "not-needed"

Personalização de agentes

# Forma curta: atribuir um tipo de modelo.
agents.coder = "large"
agents.task  = "small"

# Forma completa: ajustar um agente.
[agents.advisor]
model           = "large"
temperature     = 0.3
thinking_budget = 32000

Servidores MCP

# Servidor MCP HTTP.
[mcp.websearch]
type = "http"
url  = "https://mcp.exa.ai/mcp?tools=web_search_exa"

Skills

# Carregamento e download automáticos na TUI ou com codg skill
[option]
skill_urls = ["https://github.com/user/skills"]

Modelos locais (llama.cpp)

[llama]
port     = 8090
host     = "127.0.0.1"
ctx_size = 32000
gpu      = "auto"          # auto, cuda, off

Canais de mensagens

[channels.telegram]
enabled     = true
token       = "$TELEGRAM_BOT_TOKEN"
allowed_ids = ["123456789"]

[channels.discord]
enabled  = true
token    = "$DISCORD_BOT_TOKEN"

Permissões

[permissions]
allowed_tools = ["bash", "edit", "view", "glob", "grep"]
allowed_dirs = ["**x"] # todos os diretórios