The free AI coding agent
Free models included, or connect any provider you like — Claude, GPT, Llama and more. No signup, no API key, no cost.
— or install the binary in one line —
Prefer a raw binary? Download from GitHub Releases or read the full install docs.
npm registry blocked or throttled? Use the
GitHub Packages registry
instead — same package, same CLI:
npm i @brogang/cli --registry=https://npm.pkg.github.com
(browse it at npm.pkg.github.com/@brogang/cli).
Linux · Windows · macOS — amd64 & arm64 · MIT licensed
An open source agent that works in your terminal.
Bro Gang AI CLI helps you write code where you already are — in the shell. Give it a task and it reads your files, edits them, searches the tree and runs commands, reporting back what it changed.
It ships with a hosted, keyless model so the first command you type already works. Everything else is optional.
# interactive session $ brogang # one shot, print, exit $ brogang "refactor the auth middleware" # auto-approve every tool $ brogang --yolo "fix the failing tests" # fully local, no network $ brogang -p ollama "explain this repo" # see what's available $ brogang --list-providers
Real tools. Real sandbox.
A genuine tool loop — not a chat box with a file picker bolted on.
Full agent loop
read_file, write_file, edit_file, list_dir, search and run_command, chained by the model across up to 24 rounds.
Sandboxed paths
Every file tool resolves against your workspace root and rejects .. escapes. Destructive shell commands ask before they run.
Zero configuration
The default provider needs no key and writes no config file. Setup is only for people who want to bring their own.
Any provider
Swap backends with -p. Eight built in, from the free hosted model to a local Ollama server.
Portable binary
Static Go build. No runtime, no node_modules, no virtualenv — it just runs.
Bang Mach theme
Neon pink and cyan built for long sessions, with spinners, box drawing and full NO_COLOR support.
Free by default. Open when you want it.
Switch backends with -p <name>.
Only the paid ones ask for a key.
| Backend | Description | Cost | API key |
|---|---|---|---|
| brogangdefault | Bro Gang AI · Cloudflare Workers AI | Free | Not required |
| ollama | Runs locally on your own machine | Free | Not required |
| cloudflare | Your own Cloudflare Workers AI account | Free tier | Required |
| groq | Groq fast inference | Free tier | Required |
| openai | GPT models | Paid | Required |
| anthropic | Claude models | Paid | Required |
| openrouter | One key, many models | Paid | Required |
| together | Together AI open models | Paid | Required |
An OpenAI-compatible API. Free and keyless.
The CLI is just a client. Point anything at it — a script, a website, another agent. Same shape as the OpenAI SDK, so swapping the base URL is often all it takes.
- 1POST /v1/chat/completions — chat, with optional tool definitions
- 2GET /v1/models — list the available model
- 3GET /v1 — endpoint metadata
curl https://brogangaicli.pages.dev/v1/chat/completions \ -H 'content-type: application/json' \ -d '{ "messages": [ {"role":"user","content":"hi"} ] }'
Questions
--setup to add a provider of your own — the default path never writes one... traversal and absolute paths outside the project. Shell commands ask for approval before running unless you pass --yolo.-p ollama and it talks to a local Ollama server instead. Everything else stays the same — same tools, same sandbox, same theme.More from BRO GANG
One crew, a few things worth your time.
PGlove
A fast, privacy-first browser built by the same crew. Pair it with the CLI and stop pasting context between windows.
pglove.jo3.org →BRO GANG
East 2022 — a community of 38 friends, one foot in Vice City, one in the blocky world. Home of the brand behind this CLI.
brogang.techaditya.workers.dev →GitHub
MIT licensed. Issues, tagged releases with prebuilt binaries, and the Cloudflare Pages endpoint that powers the free tier.
TechAdityaBRO/brogang-cli →One command. Zero setup.
Install it, run it, and it works — no key, no account, no trial counting down.
— or install the binary in one line —