Name: Blazecode
Author: Alok

A lightweight terminal coding agent. Stream responses, edit with five tools, keep config local.

Install

Linux and macOS. Requires Python 3.11+, curl (or wget), and tar.

$ curl -fsSL https://raw.githubusercontent.com/thealokverse/blazecode/main/install.sh | bash

Installs into ~/.local/share/blazecode and linksblazecode to ~/.local/bin. Config in~/.blazecode is never touched by install or update.

# update (re-run install)
curl -fsSL https://raw.githubusercontent.com/thealokverse/blazecode/main/install.sh | bash

# uninstall (keeps ~/.blazecode)
curl -fsSL https://raw.githubusercontent.com/thealokverse/blazecode/main/install.sh | bash -s -- --uninstall

# pin a version
curl -fsSL https://raw.githubusercontent.com/thealokverse/blazecode/main/install.sh | bash -s -- --version v1.1.0

# pip / uv
pip install git+https://github.com/thealokverse/blazecode.git
uv tool install git+https://github.com/thealokverse/blazecode.git

Quick start

blazecode                          # interactive REPL
blazecode -p "Explain this repo"   # one-shot
blazecode --version
blazecode --provider openrouter --model anthropic/claude-sonnet-4

First launch walks through a provider and writes ~/.blazecode/config.json.

Tools

Tool	Role
read	Read a file (offset/limit)
write	Create or replace a file
edit	Exact string replacement
bash	Foreground shell command
grep	Regex search

Paths stay inside the working directory. Mutating tools go through the approval gate.

Approvals

Mode	Behavior
ask	Confirm write / edit / bash
auto	Allow mutations without prompts
plan	Read-only

Toggle with /approval.

Commands

Type / for fuzzy completion.

/help       list commands
/status     provider, model, approval, tokens
/approval   on | off
/provider   add or switch provider
/models     switch models
/skills     list or add skills
/export     export session to Markdown
/clear      fresh session
/resume     resume a saved session
/exit       quit

Configuration

Prefer env:VARIABLE for API keys. Project guidance is read fromAGENTS.md, BLAZECODE.md, or README.md.

{
  "default_provider": "openai",
  "default_model": "gpt-4.1",
  "approval_mode": "ask",
  "providers": [
    {
      "name": "openai",
      "base_url": "https://api.openai.com/v1",
      "api_key": "env:OPENAI_API_KEY",
      "models": ["gpt-4.1"]
    }
  ]
}

License

MIT.Source on GitHub.

Blazecode docs