freebuff

The free coding agent

63 articles 10.2k View on GitHub ↗
63 articles
How to Contribute to the Freebuff Project: A Developer's Guide to the AI Agent Framework

Learn how to contribute to the Freebuff AI agent framework. Fork the repo, install dependencies, branch, and submit a pull request to join the Freebuff project.

how-to-guide
Sep 1, 2026
How the Public Freebuff Repository Mirrors the Private Codebuff Source Tree

Discover the relationship between the public Freebuff repository and the private Codebuff source tree. Learn how contributions flow through a port-and-export workflow.

internals
Sep 1, 2026
How Freebuff Handles Strict Typing with TypeScript: A Layered Type Safety Architecture

Learn how Freebuff achieves strict typing with TypeScript using a layered architecture. Discover its approach to type safety, project references, and Zod runtime validation.

architecture
Sep 1, 2026
How Freebuff Uses tmux Helper Scripts for End-to-End Testing

Learn how Freebuff leverages tmux helper scripts to automate its end-to-end testing suite. Discover how shell scripts and TypeScript wrappers control the interactive TUI for seamless testing.

how-to-guide
Sep 1, 2026
What Is the Role of the `freebuff/` Workspace in the CodebuffAI/freebuff Repository?

Discover the role of the freebuff/ workspace in CodebuffAI/freebuff. Learn how it isolates the CLI product's code, build, tests, and release automation within the monorepo.

internals
Sep 1, 2026
Freebuff LLM Providers: Complete Guide to Supported Services and Integration

Explore Freebuff LLM providers. Integrate seamlessly with OpenAI, Azure OpenAI, OpenRouter & more via the OpenAI API. Simplify your LLM services.

getting-started
Sep 1, 2026
How Freebuff Uses Tree-Sitter for Source Code Parsing: A Complete Technical Guide

Discover how Freebuff uses Tree-Sitter with WebAssembly for efficient, language-agnostic source code parsing across Node, Bun, and browsers. A complete technical guide.

deep-dive
Sep 1, 2026
What Does the agent-runtime Package Do in Freebuff?

Discover the @codebuff/agent-runtime package, Freebuff's LLM agent execution engine. It handles prompt construction, token budgeting, tool dispatching, and output validation in a continuous loop.

internals
Sep 1, 2026
How Freebuff Manages Public Agent Definitions: Bundled and Custom Agents Explained

Discover how Freebuff manages public agent definitions using bundled and custom agents. Learn about its dual-layer system for efficient agent management and dynamic loading.

architecture
Sep 1, 2026
What Is the Common Workspace in Freebuff? Purpose, Architecture, and Code Examples

Discover the common workspace in Freebuff, its purpose, architecture, and how it centralizes shared types, schemas, and utilities across the monorepo for consistency and efficiency. Explore code examples.

deep-dive
Sep 1, 2026
How to Get Diagnostic Information About Active Terminal Command Processes in Freebuff

Get Freebuff diagnostic information for active terminal commands using collectProcessDiagnostics() or runTerminalCommand. Capture PID, args, timestamps, and output easily.

how-to-guide
Sep 1, 2026
TerminalCommandBroker Interface in the Freebuff SDK: A Deep Dive into Process Isolation

Explore the TerminalCommandBroker interface in Freebuff SDK. Learn how it enables cross-platform process isolation and prevents UI blocking for reliable CLI operations.

deep-dive
Sep 1, 2026

Have a question about this repo?

These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:

Share the following with your agent to get started:
curl -s "https://instagit.com/install.md"
Works with
Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →