JSPM

Agente de IA multi-modelo para o seu terminal — qualquer modelo, toda ferramenta, zero limites.

🌐 Site · 📦 npm · 📖 Docs · ⭐ GitHub

O que é o CoreCode?

CoreCode é um agente de IA open-source que roda inteiramente no seu terminal. Alterne entre OpenAI, Groq (grátis), Gemini, Anthropic, Ollama e qualquer API compatível com OpenAI — tudo com comandos simples como /model e /provider, sem GUI.

Criado por Estevam Souza como uma alternativa rápida, extensível e aberta às ferramentas de IA que prendem o usuário em um único provedor.

Funcionalidades principais

Instalação

Via npm (recomendado)

npm install -g @estevamsl/corecode

Via curl

curl -fsSL https://raw.githubusercontent.com/estevam5s/CoreCode/main/install.sh | sh

Depois execute:

corecode

Requer Node.js ≥ 20. Sem outras dependências globais.

Início rápido

1. Obtenha uma chave de API gratuita (Groq — recomendado)

Groq é 100% gratuito, sem necessidade de cartão de crédito. Pegue sua chave em console.groq.com.

2. Configure sua chave

Opção A — variável de ambiente (recomendado)

export GROQ_API_KEY=gsk_sua_chave_aqui
corecode

Opção B — arquivo .env (crie no diretório de trabalho)

GROQ_API_KEY=gsk_sua_chave_aqui
CORECODE_DEFAULT_PROVIDER=groq

Opção C — defina em runtime (sem arquivo)

corecode
> /key groq gsk_sua_chave_aqui
> /provider groq

3. Comece a programar

$ corecode

  ██████╗ ██████╗ ██████╗ ███████╗
  ██╔════╝██╔═══██╗██╔══██╗██╔════╝
  ██║     ██║   ██║██████╔╝█████╗
  ██║     ██║   ██║██╔══██╗██╔══╝
  ╚██████╗╚██████╔╝██║  ██║███████╗
   ╚═════╝ ╚═════╝ ╚═╝  ╚═╝╚══════╝

  ██████╗ ██████╗ ██████╗ ███████╗
  ██╔════╝██╔═══██╗██╔══██╗██╔════╝
  ██║     ██║   ██║██║  ██║██╔══╝
  ╚██████╗╚██████╔╝██████╔╝███████╗
   ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝

  + Any model. Every tool. Zero limits. +

  ┌────────────────────────────────────────────────┐
  │  Provider    Groq                              │
  │  Model       llama-3.3-70b-versatile           │
  │  Endpoint    https://api.groq.com/openai/v1    │
  └────────────────────────────────────────────────┘

  ● cloud   Ready — type /help to begin

  corecode v0.1.8

  ● groq/llama-3.3-70b-versatile · tools: file bash search

> explique este arquivo @src/auth/middleware.ts
● Analisando src/auth/middleware.ts...

Referência de comandos

Sessão

Modelo & Provedor

Conversa

System Prompt

Ferramentas

Exportar

Provedores

Groq — grátis, ultra-rápido

/provider groq
/model llama-3.3-70b-versatile      # recomendado — melhor qualidade
/model llama-3.1-8b-instant         # mais rápido
/model deepseek-r1-distill-llama-70b
/model gemma2-9b-it
/model mixtral-8x7b-32768

Chave gratuita em console.groq.com — sem cartão de crédito.

Ollama — 100% local, offline

# Instale o Ollama primeiro: https://ollama.ai
ollama pull qwen2.5-coder:7b
ollama serve

/provider ollama
/model qwen2.5-coder:7b

Anthropic Claude

export ANTHROPIC_API_KEY=sk-ant-...
/provider anthropic
/model claude-sonnet-4-6
/model claude-opus-4-6

OpenAI-compatible (LM Studio, vLLM, Jan)

export OPENAI_BASE_URL=http://localhost:1234/v1
export CORECODE_DEFAULT_PROVIDER=openai-compatible
corecode

Variáveis de ambiente

Coloque estas variáveis em um arquivo .env no diretório de trabalho ou exporte no shell.

Uso avançado

Trocar de provedor no meio da conversa

> /provider anthropic
● anthropic · claude-sonnet-4-6

> explique async/await em profundidade
● …

> /provider groq
● groq · llama-3.3-70b-versatile

> /model gemma2-9b-it
● gemma2-9b-it

Carregar todos os arquivos TypeScript de um projeto

> @src/**/*.ts revise o fluxo de autenticação
● Lendo 12 arquivos TypeScript...
● Encontrei possíveis problemas em auth/middleware.ts...

Executar um comando shell e perguntar sobre a saída

> !git log --oneline -20
> o que mudou nos últimos 5 commits?
● Analisando o histórico do git...

Buscar na web e usar como contexto

> /search melhores práticas React hooks 2025
● Pesquisando via DuckDuckGo...
> com base nisso, refatore meu hook @src/useAuth.ts

Salvar conversa como Markdown

> /save sessao-2025-01-15.md
● saved → /Users/you/sessao-2025-01-15.md

Compactar um histórico longo

> /compact
● 38 mensagens compactadas em resumo

Definir chave de API em runtime (sem arquivo .env)

> /key anthropic sk-ant-api03-...
● ANTHROPIC_API_KEY definida para esta sessão
> /provider anthropic
● anthropic · claude-sonnet-4-6

Estrutura do projeto

CoreCode/
├── src/corecode/
│   ├── main.ts              # entrypoint — carrega .env e inicia REPL
│   ├── repl.ts              # loop REPL + orquestração de ferramentas
│   ├── commands.ts          # todos os slash commands (/model, /provider...)
│   ├── router.ts            # roteamento de provedores
│   ├── state.ts             # estado da sessão (provider, model, history)
│   ├── banner.ts            # logo ASCII em gradiente laranja
│   ├── welcome.ts           # caixa de informações na inicialização
│   ├── highlighter.ts       # renderizador de syntax highlighting
│   ├── spinner.ts           # indicador de carregamento animado
│   ├── setup-wizard.ts      # wizard de primeiro uso para chaves de API
│   └── providers/
│       ├── openai.ts        # OpenAI + OpenAI-compatible (streaming SSE)
│       ├── groq.ts          # Groq (compatível com OpenAI)
│       ├── gemini.ts        # Google Gemini (API nativa)
│       ├── anthropic.ts     # Anthropic Claude (API nativa)
│       ├── ollama.ts        # Ollama local
│       └── mock.ts          # modo demo sem chave de API
│   └── tools/
│       ├── fileTool.ts      # agente de leitura de arquivos + glob
│       ├── bashTool.ts      # executor de comandos shell com confirmação
│       ├── webSearch.ts     # busca DuckDuckGo
│       └── diffTool.ts      # aplicador de patches de código
├── scripts/
│   └── build-corecode.ts    # script de build dedicado (Bun)
├── dist/
│   └── cli.mjs              # binário compilado self-contained
├── bin/
│   └── corecode.js          # wrapper npm bin (shebang node)
├── public/
│   ├── corecode.png         # logo original
│   ├── docs-banner.svg      # banner da documentação
│   └── icon.svg             # ícone do site
├── .env.example             # template de variáveis de ambiente
└── package.json             # @estevamsl/corecode

Build a partir do código-fonte

# Clone o repositório
git clone https://github.com/estevam5s/CoreCode.git
cd CoreCode

# Instale as dependências (requer Bun ≥ 1.0)
npm install

# Build (compila src/corecode/main.ts → dist/cli.mjs)
bun run build

# Registre globalmente para desenvolvimento
npm link

# Execute
corecode

Arquitetura

stdin → readline REPL → detectFileReferences() → readFiles()
                      → detectBashCommand()    → runBashTool()
                      → detectSlashCommand()   → handleCommand()
                      → sendToAI(provider)     → streamResponse()
                                                   ├── Groq SSE
                                                   ├── OpenAI SSE
                                                   ├── Gemini stream
                                                   ├── Anthropic stream
                                                   └── Ollama stream
                      ← bufferResponse()
                      ← renderResponse()       ← highlighter
                      ← processDiffs()         ← diffTool

Contribuindo

Pull requests são bem-vindos. Veja CONTRIBUTING.md para diretrizes.

# Fork → clone → branch
git checkout -b feature/minha-funcionalidade

# Desenvolva e teste
bun run build
corecode

# Abra um PR

Autor

Criado por Estevam Souza

• GitHub: @estevam5s
• Site: core-code-landing.vercel.app
• npm: @estevamsl/corecode
• Projeto: github.com/estevam5s/CoreCode

Licença

MIT © Estevam Souza