An open protocol for agentic task coordination.
Brainfile is a file-based task management system that keeps project coordination inside your codebase, where your agents live and work.
- Board: Active tasks live in
.brainfile/board/as individual markdown files. - Logs: Completion records are appended to
.brainfile/logs/ledger.jsonlfor permanent history. - Rules: Configuration and promoted ADRs inject context into every agent interaction.
- Strict Types: Tasks, Epics, and ADRs with schema validation.
- Contracts: Define deliverables and validation for AI agents.
- ADR Promotion: Turn architectural decisions into active rules.
- Agent Tools: CLI, MCP server, and Python/TypeScript libraries.
| Package | Description |
|---|---|
| @brainfile/cli | CLI with TUI and MCP server |
| @brainfile/core | TypeScript library |
| brainfile | Python library |
| Protocol | Specification and JSON schemas |
