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.

Install — pick your package manager, or use the one-liner
$ npm install -g @brogang/cli

— or install the binary in one line —

$ curl -fsSL https://brogangaicli.pages.dev/install.sh | bash
> irm https://brogangaicli.pages.dev/install.ps1 | iex
> curl -fsSL https://brogangaicli.pages.dev/install.cmd -o install.cmd && install.cmd

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

brogang — ~/project
$ brogang "add error handling to the fetch call"​❯ brogang ▸ Bro Gang AI (free, no key)⚡ read_file path: src/api.ts⚡ edit_file path: src/api.ts ── step 3/24​Wrapped the call in try/catch, added a typed error branch andpropagated the original cause. Tests still pass.​$ ✔ done in 6.2s · $0.00
Fig 1. A full agent turn — two tool calls, one edit, zero configuration.
$0
Fig 1. Cost, forever
The default model runs on Cloudflare Workers AI. No trial, no card, no timer.
0
Fig 2. Setup steps
Install and run. No account, no token, no config file written on first launch.
6
Fig 3. Target platforms
Prebuilt binaries for Linux, Windows and macOS on amd64 and arm64.
What is Bro Gang AI CLI?

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.

Usage
# 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
Capabilities

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.

Providers

Free by default. Open when you want it.

Switch backends with -p <name>. Only the paid ones ask for a key.

BackendDescriptionCostAPI key
brogangdefaultBro Gang AI · Cloudflare Workers AIFreeNot required
ollamaRuns locally on your own machineFreeNot required
cloudflareYour own Cloudflare Workers AI accountFree tierRequired
groqGroq fast inferenceFree tierRequired
openaiGPT modelsPaidRequired
anthropicClaude modelsPaidRequired
openrouterOne key, many modelsPaidRequired
togetherTogether AI open modelsPaidRequired
Open endpoint

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
curl https://brogangaicli.pages.dev/v1/chat/completions \
  -H 'content-type: application/json' \
  -d '{
    "messages": [
      {"role":"user","content":"hi"}
    ]
  }'
FAQ

Questions

Yes. The default provider runs on a hosted Cloudflare Workers AI endpoint that requires no account and no API key. There is no trial, no card, and no usage cap tied to you. You can also point it at your own paid provider or a local Ollama server at any time.
No. Install the binary and run it. A configuration file is only created if you explicitly run --setup to add a provider of your own — the default path never writes one.
File tools are confined to your workspace root: every path is resolved against it and anything that escapes is rejected, including .. traversal and absolute paths outside the project. Shell commands ask for approval before running unless you pass --yolo.
The reference implementation is written in Go and ships as a static binary for Linux, Windows and macOS on amd64 and arm64. TypeScript and Python packages are on the way, alongside the rest of the language matrix.
Yes. Run it with -p ollama and it talks to a local Ollama server instead. Everything else stays the same — same tools, same sandbox, same theme.
Only the context needed for the current turn is sent to whichever provider you selected. The default endpoint runs on Cloudflare Workers AI and does not persist your prompts.
Get started

One command. Zero setup.

Install it, run it, and it works — no key, no account, no trial counting down.

Install — pick your package manager, or use the one-liner
$ npm install -g @brogang/cli

— or install the binary in one line —

$ curl -fsSL https://brogangaicli.pages.dev/install.sh | bash
> irm https://brogangaicli.pages.dev/install.ps1 | iex
> curl -fsSL https://brogangaicli.pages.dev/install.cmd -o install.cmd && install.cmd