Freebuff
Freebuff
- freebuff
Codebuff based. Knowledge files instead of rules, chats under ~/.config/manicode.
- Invoke
- no headless mode
- Models
- no listing
- MCP
- json · standard
- Agents file
- ~/.AGENTS.md
Access
- Get
getHarness("freebuff") - CLI
harnesses paths freebuff --json - Tryfreebuff in the explorer
Freebuff is Codebuff underneath, and the directory still says so, which I like more than a rename that hides history: user data lives under ~/.config/manicode/ on every platform. Each chat is a directory with messages, metadata, run state and a log.jsonl. Instructions are knowledge files: knowledge.md per directory, *.knowledge.md, AGENTS.md and CLAUDE.md all loaded the same way, and ~/.AGENTS.md at the user level, read-only for the agent.
.agents/skills/ is both its skills directory and the install target of npx skills add. MCP servers are the standard dialect in .agents/mcp.json and ~/.agents/mcp.json. No headless invocation is recorded, so every mode is rejected. Detection is by .agents or knowledge.md; a project whose .agents/ also holds skills/ matches Codex too, and two matches make detectHarness return null.
Capabilities and invocation
- mcp: yes
- vision: yes
- audio: no
- video: no
- tools: yes
- streaming: yes
No non-interactive invocation is recorded, so invoke() rejects before spawning anything and every invocation mode reports false.
Paths
Templates as the registry stores them. ~, ${HOME}, ${TMPDIR} and %VAR% expand in resolve(); entries tagged with a platform are dropped on the others. Open in the explorer to see them expanded for a home directory of your choice.
config
~/.config/manicode/settings.jsonFreebuff is Codebuff-based; user data lives under ~/.config/manicode/ on all platforms.
~/.config/manicode/credentials.jsonAuthentication credentials.
sessions
~/.config/manicode/projects/<project-name>/chats/<timestamp>/Per-chat directories with chat-messages.json, chat-meta.json, run-state.json, and log.jsonl.
~/.config/manicode/message-history.jsonPrompt history.
instructions
AGENTS.mdKnowledge files; scaffolded by the init flow. knowledge.md, *.knowledge.md, and CLAUDE.md in any project directory are loaded the same way.
knowledge.mdPer-directory project knowledge.
~/.AGENTS.mdUser-level knowledge files in the home directory; ~/.knowledge.md and ~/.CLAUDE.md are accepted too. Read-only for the agent.
skills
.agents/skills/Also the install target for community skills via npx skills add; .agents/types/ holds agent template types.
Empty
commandspromptTemplateshookstempThat is not the same as the feature being missing.
MCP servers
~/.agents/mcp.jsonuser · json · standard · mcpServers.agents/mcp.jsonproject · json · standard · mcpServers
Detection
envVars
None. Detection is by project markers only.
projectMarkers
- .agents
- knowledge.md
Persistence
- JSON - Settings, credentials, chat messages, and run state. (official)
- JSONL - Per-chat logs (log.jsonl). (official)
syncAgentsFiles links ~/.AGENTS.md to the master bundle.