GCloude

Agente de IA recriado a partir da arquitetura observada em ClaudeSRcode/src, agora com nome GCloude.

Documentos adicionais:

• INSTALL.md
• CHANGELOG.md
• RELEASE.md
• LICENSE

Publicacao:

• o pacote ja esta preparado para distribuicao como gcloude
• o binario exposto e gcloude
• para uso local, voce pode executar npm link
• para publicar no npm, use npm login antes de npm publish
• release atual no GitHub: https://github.com/alexandrexgama/GCloude/releases/tag/v1.2.2

O foco aqui foi reproduzir o desenho central do sistema original, sem a complexidade de UI Ink, telemetria, MCP, OAuth, LSP e feature flags.

Estado atual

Esta versao ja inclui uma v2 leve com:

• streaming de resposta no terminal
• confirmacao para tools destrutivas
• REPL simples com execucao incremental

v3

• tool apply_patch
• modos de permissao: read-only, ask, auto

v4

• retomada de sessao por --session ou --resume-latest
• parser de streaming mais completo para text e tool_use
• suporte inicial e experimental a MCP stdio via .gcloude/mcp.json

O que foi preservado do design original

• cli -> context -> prompt -> query loop -> tools
• prompt de sistema modular
• suporte a GCLOUDE.md
• loop com tool_use / tool_result
• registry central de ferramentas
• persistencia simples de transcript em JSONL

Ferramentas implementadas

• bash
• read
• write
• edit
• apply_patch
• glob
• grep

Requisitos

• Node.js 18+
• credenciais do provider configuradas

Uso

Tambem e suportado carregar variaveis por .env, .env.local, .gcloude/.env e .gcloude/.env.local.

Se AGENT_API_KEY nao estiver configurada, o GCloude abre um onboarding interativo no terminal para:

• escolher o provider/agente
• preencher automaticamente a API URL
• aplicar automaticamente o modo de permissao padrao
• mostrar a lista de modelos sugeridos
• solicitar a credencial necessaria

Depois disso, ele salva tudo em .gcloude/.env.local.

Providers/agentes suportados nesta versao:

• anthropic
• openai
• openrouter
• groq
• xai
• ollama
• lmstudio

Use .env.example como base para sua configuracao local.

cd /home/kali/ClaudeCodeAgente/ClaudeSRcode/gcloude
AGENT_API_KEY=... npm start -- "analise este projeto"

Modo interativo:

cd /home/kali/ClaudeCodeAgente/ClaudeSRcode/gcloude
AGENT_API_KEY=... npm start

Retomar a ultima sessao:

cd /home/kali/ClaudeCodeAgente/ClaudeSRcode/gcloude
AGENT_API_KEY=... npm start -- --resume-latest

Comandos do REPL:

• /help mostra comandos
• /sessions lista sessoes conhecidas
• /resume latest retoma a sessao mais recente
• /resume <id> troca para uma sessao especifica
• /new abre uma sessao nova
• /model mostra o modelo ativo
• /set-model <model> troca o modelo ativo
• /providers lista os providers/agentes suportados
• /logout remove a configuracao salva e desconecta a sessao atual
• /config mostra a configuracao ativa
• /logs [n] mostra logs recentes
• /export latest [md|json] exporta uma sessao
• /export <id> [md|json] exporta uma sessao especifica
• /mcp mostra status dos servidores MCP
• /exit encerra o REPL

Flags uteis do CLI:

• --sessions
• --new-session
• --mcp
• --export-session <id> --export-format md|json
• --export-latest --export-format md|json
• --model <name>
• --cleanup
• --logout
• npm test

Observacoes

• O agente e funcional, mas e um MVP.
• Usa apenas a API Messages da Anthropic via fetch nativo.
• As ferramentas de filesystem priorizam o workspace atual.
• Os transcripts sao gravados em .gcloude/sessions/.
• Exportacoes sao gravadas em .gcloude/exports/.
• Logs estruturados sao gravados em .gcloude/logs/.
• --cleanup remove sessoes antigas e logs antigos com retencao padrao.
• write, edit e comandos bash potencialmente destrutivos pedem confirmacao no modo interativo.
• apply_patch tambem passa pela politica de permissao.
• MCP e experimental nesta versao, mas tolera falha de servidores individualmente e espera configuracao em .gcloude/mcp.json.
• Sessoes longas passam a gravar um resumo simples em metadados.

MCP experimental

Copie .gcloude/mcp.example.json para .gcloude/mcp.json e ajuste os servidores stdio que deseja expor ao GCloude.

Modos de permissao

• read-only: bloqueia tools de escrita
• ask: pede confirmacao para acoes destrutivas
• auto: executa sem confirmacao local