AGENTS.md · CodebuffAI/freebuff

AGENTS.md from CodebuffAI/freebuff: 36 lines covering Key Technologies, Repo Map, Conventions, Docs.

IndexedApache-2.0★ 13,724

Chalk Labs

Need help deploying AGENTS.md · CodebuffAI/freebuff?

Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.

Book a call

Install

Works with Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Claude Code. Read the repository before you give any tool access to your data.

curl -fsSL https://raw.githubusercontent.com/CodebuffAI/freebuff/main/AGENTS.md -o AGENTS.md

Read it and adapt it to your project before use.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

The AGENTS.md file that CodebuffAI/freebuff (13,720 stars) keeps for coding agents. It has 36 lines in 4 sections: Key Technologies; Repo Map; Conventions; Docs. Use it as a model for your own project's instructions.

Use cases: documentation

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

What's in it

An AGENTS.md file: instructions coding agents (Codex, Cursor, Copilot, Gemini CLI and others) read before working in a repo.

For: Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Claude Code
Length: 36 lines
File: AGENTS.md

Sections

Key Technologies
Repo Map
Conventions
Docs

First lines (shown under the repo's Apache-2.0 license)

# Freebuff

Freebuff is the public, free coding agent built from the Codebuff agent framework.

## Key Technologies

- TypeScript monorepo
- Bun runtime and package manager
- OpenTUI + React CLI
- JS/TS SDK
- Composable agent runtime

## Repo Map

- `cli/` - TUI client and local UX
- `sdk/` - JS/TS SDK used by the CLI and external users
- `common/` - shared types, tools, schemas, and utilities
- `agents/` - public agent definitions
- `packages/agent-runtime/` - agent runtime and tool handling
- `packages/code-map/` - source parsing helpers
- `packages/llm-providers/` - public LLM provider shims
- `freebuff/` - Freebuff CLI, release files, and e2e tests
- `scripts/tmux/` - tmux helpers for CLI testing

## Conventions

- Use `bun install` and `bun run`.
- Prefer dependency injection over module mocking.
- Run interactive CLI tests in tmux.
- Do not force-push `main`.

## Docs

- `docs/agents-and-tools.md`
- `docs/testing.md`

Signals

Stars: 13,724
Forks: 1,457
Open issues: 172
Last commit (this folder): Jun 4, 2026 (4 months ago)

From GitHub (fetched Oct 24, 2026).

Details

License: Apache-2.0
Repository: github.com/CodebuffAI/freebuff
First seen: Oct 24, 2026
Last checked: Oct 24, 2026
Source: GitHub github-graphql

Done for you

Rather not set it up yourself?

Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.

See how we build AI agents →Read the case studies

Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.

launches shipped: 50+; launches shipped
media placements: 500+; media placements
founders on every account: 2; founders on every account

Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block

Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.

Get AGENTS.md · CodebuffAI/freebuff running in your business

Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.

Need help deploying AGENTS.md · CodebuffAI/freebuff?

Call Get help

Cite this page

AGENTS.md · CodebuffAI/freebuff. Agent Mart. https://agentmart.dev/templates/codebuffai-freebuff-agents-md (last updated 2026-10-24)