Harnesses

Freebuff

Codebuff based. Knowledge files instead of rules, chats under ~/.config/manicode on every platform, skills at .agents/skills, no headless mode.
getHarness
getHarness("freebuff")
binary
freebuff
invoke modes
none
model listing
no
mcp config
json · standard
agents file
~/.AGENTS.md

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: yesvision: yesaudio: novideo: notools: yesstreaming: 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} 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.jsonuser · official · allFreebuff is Codebuff-based; user data lives under ~/.config/manicode/ on all platforms.
  • ~/.config/manicode/credentials.jsonuser · official · allAuthentication credentials.

sessions

  • ~/.config/manicode/projects/<project-name>/chats/<timestamp>/data · official · allPer-chat directories with chat-messages.json, chat-meta.json, run-state.json, and log.jsonl.
  • ~/.config/manicode/message-history.jsondata · official · allPrompt history.

instructions

  • AGENTS.mdproject · official · allKnowledge files; scaffolded by the init flow. knowledge.md, *.knowledge.md, and CLAUDE.md in any project directory are loaded the same way.
  • knowledge.mdproject · official · allPer-directory project knowledge.
  • ~/.AGENTS.mduser · official · allUser-level knowledge files in the home directory; ~/.knowledge.md and ~/.CLAUDE.md are accepted too. Read-only for the agent.

skills

  • .agents/skills/project · official · allAlso the install target for community skills via npx skills add; .agents/types/ holds agent template types.

empty

commandshooks No known location. That 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

.agentsknowledge.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.

@agntn/harnesses·MIT license· Paths follow the upstream CLIs and carry their evidence level. This site reads nothing from your machine.