JSPM

ADVANCED MULTI-MODEL AI CODING AGENT CLI

+ Any model. Every tool. Zero limits. +

What is CoreCode?

CoreCode is a multi-model, multi-provider AI coding agent that runs entirely in your terminal. Switch between OpenAI, Groq (free), Gemini, Anthropic, Ollama and any OpenAI-compatible API — all with simple slash commands, no GUI required.

Built by Estevam Souza as a fast, extensible, and open alternative to cloud-locked AI tools.

Key features

• 7 providers out of the box — Groq, OpenAI, Gemini, Anthropic, Ollama, OpenAI-compatible, Mock
• Live provider/model switching — /provider groq then /model llama-3.3-70b-versatile
• File agent — mention any file in your message or use @path/to/file
• Bash tool — run shell commands with !<command> and inject output into context
• Web search — /search <query> via DuckDuckGo, no API key needed
• Diff tool — AI-generated patches applied automatically via // FILE: markers
• Syntax highlighting — VS Code Dark+ palette for 8 languages
• Animated spinner — "Wibbling… Wrangling… Thinking…" while waiting
• Session management — /save, /export, /compact, /retry, /copy
• Runtime API keys — /key groq sk-... without touching .env

Install

npm install -g @estevamsl/corecode

That's it. Then run:

corecode

Requires Node.js ≥ 20. No other global dependencies.

Quick start

1. Get a free API key (Groq — recommended)

Groq is 100% free, no credit card required. Get your key at console.groq.com.

2. Set your key

Option A — environment variable (recommended)

export GROQ_API_KEY=gsk_your_key_here
corecode

Option B — .env file (create in your working directory)

echo "GROQ_API_KEY=gsk_your_key_here" > ~/.corecode.env

Option C — set at runtime (no file needed)

corecode
# then inside the CLI:
/key groq gsk_your_key_here
/provider groq

3. Start coding

corecode

  ████████╗
  ██╔═══██╗  CoreCode v0.1.7
  ████████╔╝  groq / llama-3.3-70b-versatile
  ╚══════╝

● cloud   Ready — type /help to begin

> explain this function @src/auth/middleware.ts

Commands reference

Session

Model & Provider

Conversation

System Prompt

Tools

Export

Providers

Groq — free, ultra-fast

/provider groq
/model llama-3.3-70b-versatile     # recommended — best quality
/model llama-3.1-8b-instant        # fastest
/model deepseek-r1-distill-llama-70b

Get your free key at console.groq.com — no credit card.

Ollama — 100% local, offline

# Install Ollama first: https://ollama.ai
ollama pull qwen2.5-coder:7b

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

OpenAI-compatible (LM Studio, vLLM, Jan)

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

Environment variables

You can also place these in a .env file in your working directory.

Advanced usage

Switch provider mid-conversation

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

> explain async/await in depth
● …

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

Load all TypeScript files from a project

> @src/**/*.ts review the authentication flow

Run a shell command and ask about the output

> !git log --oneline -20
> what changed in the last 5 commits?

Save a conversation to Markdown

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

Compact a long conversation

> /compact
● 38 messages compacted into summary

Project structure

CoreCode/
├── src/corecode/
│   ├── main.ts              # entrypoint
│   ├── repl.ts              # REPL loop + tool orchestration
│   ├── commands.ts          # all slash commands
│   ├── router.ts            # provider routing
│   ├── state.ts             # session state
│   ├── banner.ts            # ASCII logo
│   ├── welcome.ts           # startup info box
│   ├── highlighter.ts       # syntax highlighting renderer
│   ├── spinner.ts           # animated loading indicator
│   ├── setup-wizard.ts      # first-run API key wizard
│   └── providers/
│       ├── openai.ts        # OpenAI + OpenAI-compatible
│       ├── groq.ts          # Groq (OpenAI-compat)
│       ├── gemini.ts        # Google Gemini
│       ├── anthropic.ts     # Anthropic Claude
│       ├── ollama.ts        # Ollama local
│       └── mock.ts          # Demo mode (no key)
│   └── tools/
│       ├── fileTool.ts      # file reading agent
│       ├── bashTool.ts      # shell command runner
│       ├── webSearch.ts     # DuckDuckGo search
│       └── diffTool.ts      # code patch applier
├── scripts/
│   └── build-corecode.ts    # dedicated build script
├── dist/cli.mjs             # compiled binary (self-contained)
├── bin/corecode             # npm bin wrapper
└── public/
    └── corecode.png         # logo image

Build from source

git clone https://github.com/estevam5s/CoreCode.git
cd CoreCode
npm install
bun run build       # requires Bun ≥ 1.0
npm link            # register `corecode` globally
corecode

Contributing

Pull requests welcome. See CONTRIBUTING.md for guidelines.

Author

Created by Estevam Souza

• GitHub: @estevam5s
• Project: github.com/estevam5s/CoreCode

License

MIT © Estevam Souza