CyberBrain

CyberBrain is a local plugin marketplace for Claude Code and Codex. It packages shared skills, commands, and agent definitions used across development workflows.

Active Plugins

Plugin	Contents	Status
awesome-agent-select	Prompted subagents for review, QA, API docs, performance, tooling, and TypeScript work	Published
tachikoma	Skills and commands for coordinating AI CLI tools such as Codex, Gemini CLI, OpenCode, Qwen, Cline, Aider, GitHub Copilot CLI, Kiro CLI, and Kimi CLI	Published
brain	Skills for epistemic audits, calculation boundaries, scientific-claim review, and whole-object responsibility	Published

Disabled Plugins

These plugins are under refactoring and are not published in the Claude Code or Codex marketplaces:

• mac-eco
• notifications

Requirements

• Claude Code, for .claude-plugin marketplace use
• Codex CLI 0.79.0 or newer, for .codex-plugin marketplace use
• jq 1.8.1 or newer for local validation
• Optional CLI tools used by tachikoma: Gemini CLI, OpenCode, Qwen, Cline, Aider, GitHub Copilot CLI, Kiro CLI, Kimi CLI
• Keep all CLI tools used by tachikoma updated to their latest available release before relying on the corresponding skill.

Claude Code Installation

Clone the repository and add it as a Claude Code marketplace:

mkdir -p ~/soft
git clone https://github.com/ansatzX/CyberBrain.git ~/soft/CyberBrain
claude plugin marketplace add ~/soft/CyberBrain

Install the active plugins:

claude plugin install awesome-agent-select@CyberBrain
claude plugin install tachikoma@CyberBrain
claude plugin install brain@CyberBrain

Uninstall:

claude plugin uninstall awesome-agent-select@CyberBrain
claude plugin uninstall tachikoma@CyberBrain
claude plugin uninstall brain@CyberBrain

Codex Installation

Clone and register the marketplace:

mkdir -p ~/soft
git clone https://github.com/ansatzX/CyberBrain.git ~/soft/CyberBrain
codex plugin marketplace add ~/soft/CyberBrain

Install plugins through the interactive plugin browser:

codex
/plugins

In the plugin browser, switch to the CyberBrain marketplace tab and install each plugin. Press Space on an installed plugin to toggle its enabled state. To remove the marketplace: codex plugin marketplace remove CyberBrain.

Agent Roles (awesome-agent-select)

Agent roles are injected via a SessionStart hook that symlinks agents/*.toml into ~/.codex/agents/, where Codex discovers them at startup. No manual setup required — agents are available on the next session start after installation.

To clean up agent symlinks from all plugins:

bash tools/cleanup-agent-symlinks.sh

Still-enabled plugins will re-create their symlinks on the next session start.

Plugin Layout

.claude-plugin/marketplace.json        # Claude Code marketplace
.agents/plugins/marketplace.json       # Codex marketplace
tools/
  cleanup-agent-symlinks.sh            # batch cleanup of agent role symlinks
plugins/
  awesome-agent-select/
    .claude-plugin/plugin.json
    .codex-plugin/plugin.json
    agents/                            # .md for Claude Code, .toml for Codex
    hooks/
      hooks.json                       # SessionStart -> symlink agents/*.toml -> ~/.codex/agents/
    skills/
  tachikoma/
    .claude-plugin/plugin.json
    .codex-plugin/plugin.json
    commands/
    skills/
    tools/
  brain/
    .claude-plugin/plugin.json
    .codex-plugin/plugin.json
    skills/
  mac-eco/                             # disabled, under refactoring
  notifications/                       # disabled, under refactoring

Plugin Details

tachikoma

tachikoma provides skills for running and coordinating external AI CLI tools.

Included skills:

• codex
• gemini-cli
• opencode
• qwen
• cline-cli
• aider
• github-copilot-cli
• kiro-cli
• kimi-cli

Included commands:

• collab-fix
• TDD-debug

tachikoma::codex and llm_router

The codex skill supports the llm_router profile for routing Codex traffic through ansatzX/llm_router.

Supported profile policy:

Profile	Model policy
default	gpt-5.4 high or gpt-5.5 high; fallback to gpt-5.3-codex
llm_router	deepseek-v4-pro xhigh only
aihubmix	gpt-5.4 high or gpt-5.5 high

Configure llm_router:

git clone https://github.com/ansatzX/llm_router.git ~/soft/llm_router
cd ~/soft/llm_router
uv sync
export DEEPSEEK_API_KEY="sk-..."
mkdir -p ~/.codex
cp llm_router.json ~/.codex/llm_router.json

Merge the llm_router provider/profile settings from codex.config.example.toml into ~/.codex/config.toml, then start the router:

uv run llm_router serve

Use it through Codex:

codex -p llm_router
codex exec -p llm_router -m deepseek-v4-pro --config model_reasoning_effort="xhigh" --skip-git-repo-check -

brain

brain provides audit-oriented skills for scientific, technical, and workflow reasoning.

Included skills:

• using-ansatz-brain
• state-machine
• think-before-you-calculate
• epistemic-systems-audit
• whole-object-responsibility

State-machine TODO:

• Add a validator that checks state nodes for completion without verification, proxy-only evidence marked verified, unresolved object drift, and open gaps before CLAIM_READY.
• Add a summarizer that rolls child agent state nodes up into a parent node without requiring concurrent writes to the same file.
• Add optional schema export for tools that want to read .state-machine/*.md as structured records.

awesome-agent-select

awesome-agent-select provides prompted subagents.

Included agents:

• api-documenter
• code-reviewer
• llm-architect
• mcp-developer
• performance-engineer
• qa-expert
• test-automator
• tooling-engineer
• typescript-pro

In Codex, agent roles are injected through a SessionStart hook (hooks/hooks.json) that symlinks agents/*.toml into ~/.codex/agents/ on every session start. The agents/*.md files are preserved for Claude Code compatibility.

File	Format	Consumer
agents/*.md	YAML frontmatter + Markdown body	Claude Code
agents/*.toml	name + description + developer_instructions	Codex

Codex discovers agent roles from ~/.codex/agents/*.toml during startup. The hook uses $PLUGIN_ROOT (set by Codex at hook runtime) and handles Unix (symlink) and Windows (copy) platforms.

Install: Use /plugins in the Codex interactive CLI to install from the CyberBrain marketplace. The plugin is copied into ~/.codex/plugins/cache/CyberBrain/awesome-agent-select/. Agents become available on the next Codex session start.

Uninstall: Uninstall through /plugins in the Codex interactive CLI, or remove the marketplace with codex plugin marketplace remove CyberBrain. Run bash tools/cleanup-agent-symlinks.sh to remove leftover symlinks from ~/.codex/agents/.

For a detailed explanation of the Codex plugin system (install/uninstall flow, hook runtime, agent role discovery), see CODEX_PLUGIN_SYSTEM.md.

Validation

Validate marketplace and plugin JSON:

jq -e . .claude-plugin/marketplace.json .agents/plugins/marketplace.json plugins/*/.claude-plugin/plugin.json plugins/*/.codex-plugin/plugin.json

Check skill metadata coverage:

find plugins -path '*/skills/*/SKILL.md' -type f | wc -l
find plugins -path '*/skills/*/agents/openai.yaml' -type f | wc -l