Install

Terminal coding agent

Blazecode (•̀ᴗ•́)

The lightweight AI coding agent for your terminal.

  • Simple.
  • Fast.
  • Reliable.
$ curl -fsSL https://raw.githubusercontent.com/thealokverse/blazecode/main/install.sh | bash
InstallGitHubDocumentation
blazecode — ~/project

Features

Small surface. Clear defaults.

A terminal agent that stays out of the way—stream, edit, approve, repeat.

Any model

OpenAI-compatible APIs. Cloud or local. Point at a base URL and go.

Streaming

Tokens arrive as they generate. Live status mascot keeps the loop honest.

Five tools

read, write, edit, bash, grep. Enough to ship. Nothing extra.

Approval mode

ask, auto, or plan. Mutating tools wait for a yes when you want them to.

Local models

Ollama and custom endpoints work out of the box. Your silicon, your rules.

Sessions

Append-only JSONL under ~/.blazecode. Resume, export, clear.

Open Source

MIT. Read it, fork it, bend it. No telemetry tax.

Installation

One line. No ceremony.

Linux and macOS. Requires Python 3.11+, curl, and tar. Config and sessions stay untouched on update.

$ curl -fsSL https://raw.githubusercontent.com/thealokverse/blazecode/main/install.sh | bash
SourceDocs
also available
# pip
pip install git+https://github.com/thealokverse/blazecode.git

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

# pinned
curl -fsSL …/install.sh | bash -s -- --version v1.1.0
  1. 01

    Install

    One curl. Isolated venv lands in ~/.local/share/blazecode.

  2. 02

    Onboard

    First run picks a provider and writes ~/.blazecode/config.json.

  3. 03

    Work

    blazecode in a repo. Prompt, approve, ship.

Providers

Bring your own endpoint.

First launch walks you through a provider. Keys prefer env:VAR. Inline secrets stay mode 0600.

OpenAIGoogleOpenRouterGroqKimiZ.aiOllamaCustom Base URL
~/.blazecode/config.json
{
  "default_provider": "openai",
  "default_model": "gpt-4.1",
  "approval_mode": "ask",
  "providers": [
    {
      "name": "ollama",
      "base_url": "http://localhost:11434/v1",
      "api_key": "none"
    }
  ]
}

Philosophy

“Software should disappear.”
No electron. No bloat. Just a fast CLI that feels at home.

local

Config and sessions stay on disk. Yours.

small

Five tools. Clear modes. No dashboard tax.

honest

Streaming you can watch. Approvals you control.