# Codebuff review

> Codebuff is an open multi-agent framework for coding agents. It powers the orchestration, tools, and SDK of the Freebuff coding agent.

Devtoolwatch Board, the week of Oct 25–31, 2026. Canonical page: https://index.devtoolwatch.com/tools/codebuff/

## TL;DR

Codebuff is the open multi-agent framework behind Freebuff, an ad-supported coding agent for the terminal, desktop, browser, and GitHub repositories. It is for developers who want agents that find files, edit code, and run checks. It splits each task across specialized agents instead of sending it through one model and one prompt.

## Codebuff at a glance

- **Category:** [Coding agents](https://index.devtoolwatch.com/categories/coding-agents/)
- **Maintained by:** Freebuff (organization, [@CodebuffAI](https://github.com/CodebuffAI) on GitHub)
- **License:** Apache 2.0
- **Language:** TypeScript, JavaScript, Shell
- **Repository:** [github.com/CodebuffAI/freebuff](https://github.com/CodebuffAI/freebuff)
- **Website:** [freebuff.com](https://freebuff.com)
- **npm package:** [codebuff](https://www.npmjs.com/package/codebuff) 1.0.688
- **Latest release:** [codebuff 1.0.688](https://www.npmjs.com/package/codebuff) on npm, Sep 8, 2026
- **First published:** Jul 9, 2024

## What Codebuff does

- Codebuff-based Freebuff finds the relevant files in a project, makes changes, and runs the checks that matter for that project.
- Codebuff orchestrates specialized agents that gather context, plan, edit or research, run tools, and review the result.
- Codebuff file-finding agents map the relevant parts of a project before editing.
- Codebuff agents can investigate documentation and test applications in a real browser.
- Codebuff lets developers create custom agents or embed them in another application through the @codebuff/sdk package.
- Freebuff Desktop isolates concurrent agents in separate workspaces and can run locally installed Claude Code and Codex agents.
- Freebuff Web and Cloud provide sandboxes, previews, terminals, and deployment workflows, and Cloud runs agents on GitHub repositories.

### How it works

Codebuff is the framework that runs Freebuff's agents. You install the Freebuff CLI with npm, change into a project directory, run freebuff, and describe what you want. Freebuff is also available as a desktop app, a web app builder, a cloud service connected to GitHub repositories, and a chat product. A curated model catalog is included, and text ads support access to those models.

## How to install Codebuff

**Freebuff CLI with npm**

```
npm install -g freebuff
```

**From source (contributors)**

```
git clone https://github.com/CodebuffAI/freebuff.git
```

### Requirements

- The codebuff npm package requires Node.js 16 or later.
- Freebuff does not require a subscription, credits, or an API key.
- Local development of the project requires Bun, Docker, and a configured .env.local file.
- Freebuff Desktop runs on macOS, Windows, and Linux. The mobile app is on Android, with iOS listed as coming soon.

### First steps

1. Install the Freebuff CLI globally with npm.
2. Change into your project directory, for example cd ~/my-project.
3. Run freebuff in the project directory.
4. Describe what you want, then review the files Freebuff changes and the checks it runs.

## Who Codebuff is for

- Developers who want a terminal coding agent without a subscription or an API key.
- Teams that want to build custom agents or embed agents in their own apps with an SDK.
- Developers who want to run several coding agents in parallel on a local machine.
- Developers who want hosted sandboxes to build and deploy full-stack apps from a browser.

### Limitations

- Freebuff funds its included models with text ads and may use your data to personalize ads and train ad models.
- Codebuff-based Freebuff gives limited model access to users outside supported regions and to VPN users.
- Freebuff model availability and limits depend on your access tier, product, and current capacity. Some models require paid plans.
- Freebuff may serve models from a quantized (Q8_0) build.

## Usage data (the week of Oct 25–31, 2026)

- Board rank: #164 overall, #61 in Coding agents, momentum score 49
- Downloads that week: 1.2k (−12% vs 4-week average)
- New GitHub stars per week (last 12 weeks): Aug 9: 890; Aug 16: 942; Aug 23: 639; Aug 30: 526; Sep 6: 302; Sep 13: 432; Sep 20: 399; Sep 27: 384; Oct 4: 298; Oct 11: 196; Oct 18: 172; Oct 25: 179

## Codebuff alternatives

| Rank | Tool | Stars | Downloads/wk |
|---|---|---|---|
| #1 | [Cindy](https://index.devtoolwatch.com/tools/makecindy-cindy/) | 8.8k | – |
| #2 | [OpenMausBot](https://index.devtoolwatch.com/tools/milind-soni-openmausbot/) | 9.6k | – |
| #3 | [Orca](https://index.devtoolwatch.com/tools/stablyai-orca/) | 111.7k | – |
| #4 | [OpenBot](https://index.devtoolwatch.com/tools/copilotkit-openbot/) | 9.1k | – |
| #5 | [Agent Reach](https://index.devtoolwatch.com/tools/panniantong-agent-reach/) | 107.2k | – |
| #6 | [Skill Recorder](https://index.devtoolwatch.com/tools/microsoft-skill-recorder/) | 5.6k | – |

## Codebuff FAQ

### Is Codebuff free and open source?

Yes. Codebuff's source code is on GitHub (CodebuffAI/freebuff) under the Apache 2.0 license, so you can use it for free.

### How do I install Codebuff?

Run `npm install -g freebuff`. It needs Node.js >=16. The install section above has the other options from the project's README.

### Is Codebuff still maintained?

Yes. The CodebuffAI/freebuff repository was last updated on Oct 25, 2026, and the latest release, codebuff 1.0.688 on npm, came out on Sep 8, 2026.

### How popular is Codebuff?

Codebuff has 13.9k GitHub stars as of Nov 1, 2026. It gained 179 new stars in the week of Oct 25–31, 2026, against a 12-week average of 447 a week. Its main package had about 1.2k downloads that week, −12% against its own 4-week average. That made it #61 among AI coding agents on the Devtoolwatch Board.

### Codebuff vs Claude Code: how do they compare?

Codebuff and Claude Code are both tracked by Devtoolwatch as AI coding agents. Codebuff has 13.9k GitHub stars and Claude Code has 154.1k. In the week of Oct 25–31, 2026, Codebuff's main package had 1.2k downloads and Claude Code's had 11.6M. Claude Code is Anthropic's agentic coding tool that reads your codebase, edits files, runs commands, and handles git workflows through natural language. [Claude Code review](https://index.devtoolwatch.com/tools/claude-code/)

### Codebuff vs OpenCode: how do they compare?

Codebuff and OpenCode are both tracked by Devtoolwatch as AI coding agents. Codebuff has 13.9k GitHub stars and OpenCode has 223.6k. OpenCode is an open source AI coding agent that helps you write and run code in a terminal, desktop app, or IDE extension. [OpenCode review](https://index.devtoolwatch.com/tools/opencode/)

### What are the best alternatives to Codebuff?

Other AI coding agents on the Devtoolwatch Board in the week of Oct 25–31, 2026, by momentum: Cindy (#1), OpenMausBot (#2), Orca (#3), OpenBot (#4), Agent Reach (#5). The alternatives table above has their numbers.

### What is the difference between Codebuff and Freebuff?

Codebuff is the open multi-agent framework that provides the orchestration, tools, and SDK. Freebuff is the ad-supported product built on Codebuff. Freebuff comes as a CLI, a desktop app, a web builder, a cloud service, and a chat product.

### Is Codebuff safe to use with my code?

Freebuff, which is built on Codebuff, says it does not give project files or connected repositories to advertising providers. It does use messages, agent traces, and files to run the service and personalize ads. Some models or features may use your data for AI training, and Freebuff shows a notice before that applies.

### Does Codebuff read files outside my project?

Freebuff says no, with a few exceptions. The exceptions are files an agent reads in the conversation, files you share, and settings such as your agent instructions and skills.

### Can I build my own agents with Codebuff?

Yes. Codebuff supports creating custom agents and embedding them in another application. The README points to the Codebuff documentation and the @codebuff/sdk npm package.

### Can Codebuff work with Claude Code or Codex?

Yes, through Freebuff Desktop. The desktop app can run locally installed Claude Code and Codex agents using your existing provider account. Those connected models are separate from Freebuff's included model catalog.

## Sources

1. [CodebuffAI/freebuff on GitHub](https://github.com/CodebuffAI/freebuff)
2. [Codebuff README](https://github.com/CodebuffAI/freebuff/blob/main/README.md)
3. [codebuff on npm](https://www.npmjs.com/package/codebuff)
4. [Codebuff website](https://freebuff.com)
5. [Release v1.0.420-beta.185 (Oct 21, 2025)](https://github.com/CodebuffAI/freebuff/releases/tag/v1.0.420-beta.185)
6. [Release v1.0.420-beta.184 (Oct 21, 2025)](https://github.com/CodebuffAI/freebuff/releases/tag/v1.0.420-beta.184)
7. [Release v1.0.420-beta.180 (Oct 19, 2025)](https://github.com/CodebuffAI/freebuff/releases/tag/v1.0.420-beta.180)
8. [Hacker News: Show HN: A free CLI coding agent, powered by ads](https://news.ycombinator.com/item?id=48578487)
9. [Devtoolwatch Board, the week of Oct 25–31, 2026](https://index.devtoolwatch.com/)