Imported from LMLiam/freebuffed (
AGENTS.md). Install upstream withnpx skills add LMLiam/freebuffed. Copyright stays with the author.
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 UXsdk/- JS/TS SDK used by the CLI and external userscommon/- shared types, tools, schemas, and utilitiesagents/- public agent definitionspackages/agent-runtime/- agent runtime and tool handlingpackages/code-map/- source parsing helperspackages/llm-providers/- public LLM provider shimsfreebuff/- Freebuff CLI, release files, and e2e testsscripts/tmux/- tmux helpers for CLI testing
Conventions
- Use
bun installandbun run. - Prefer dependency injection over module mocking.
- Run interactive CLI tests in tmux.
- Do not force-push
main.
Docs
docs/agents-and-tools.mddocs/testing.md