Code Buster Agent

Portable agent skills and plugin packaging for using Code Buster to map, inspect, and review software repositories.

This repository packages one canonical code-buster skill for multiple agent ecosystems. It does not contain the Code Buster analyzer itself; cb must be installed separately.

Requirements

• Code Buster 0.7.1 or newer
• A local repository to analyze

Verify the CLI before invoking the skill:

cb version
cb doctor

Install with the Agent Skills CLI

The open Agent Skills CLI installs the canonical skill for Codex, Claude Code, Cursor, Gemini CLI, GitHub Copilot, and other compatible agents:

npx skills add tool-bunker/code-buster-agent@code-buster -g -y

Omit -g for a project-local installation. Confirm discovery with:

npx skills list -g

Install as a native plugin

The repository also includes native discovery manifests for hosts that support repository plugins. Every manifest points to skills/code-buster/; none carries a second copy of the instructions.

Claude Code

/plugin marketplace add tool-bunker/code-buster-agent
/plugin install code-buster@tool-bunker

Codex

codex plugin marketplace add tool-bunker/code-buster-agent
codex plugin add code-buster@tool-bunker

GitHub Copilot CLI

copilot plugin marketplace add tool-bunker/code-buster-agent
copilot plugin install code-buster@tool-bunker

Gemini CLI and compatible extension hosts

gemini extensions install https://github.com/tool-bunker/code-buster-agent

Kimi Code

/plugins install https://github.com/tool-bunker/code-buster-agent

Reload Kimi or start a new session after installation.

Devin CLI

devin plugins install tool-bunker/code-buster-agent

Grok Build

grok plugin install tool-bunker/code-buster-agent --trust

Enable the plugin in Grok after installation.

Install in Pi

Install the npm package and reload Pi:

pi install npm:code-buster-agent

Invoke the skill explicitly with /skill:code-buster, or let Pi load it when a repository-analysis task matches its description.

Install in Cursor

The repository includes a Cursor plugin manifest. After marketplace acceptance, install code-buster from Cursor → Customize → Plugins. Until then, use the Agent Skills CLI installation above.

Why there are no copied rules or settings hooks

Code Buster is task-triggered analysis, not an always-on coding persona. It does not need lifecycle hooks, per-agent settings, or duplicated rule files. Keeping one canonical skill avoids drift and lets each host activate it only for repository-analysis work.

What the skill provides

• Repository mapping with summary, structure, graph, and clusters
• Focused impact analysis with inspect, related, why, and path
• Quality investigation with dead, duplication, complexity, and hotspots
• Changed-scope review with review, pr, and --changed
• Evidence-based interpretation of actionable findings, advisories, security hotspots, and processing diagnostics
• Safe remediation and verification guidance

The skill treats Code Buster findings as evidence requiring source inspection. It does not instruct agents to blindly remove findings or suppress heuristics.

Repository layout

.agents/plugins/       Shared marketplace discovery
.claude-plugin/        Claude Code plugin and marketplace
.codex-plugin/         Codex plugin
.cursor-plugin/        Cursor plugin
.devin-plugin/         Devin plugin
.github/plugin/        GitHub Copilot CLI plugin and marketplace
.grok-plugin/          Grok Build marketplace
.kimi-plugin/          Kimi Code plugin
gemini-extension.json  Gemini CLI extension
skills/
  plugin.json          Generic skill collection manifest
  code-buster/
    SKILL.md            Canonical instructions
    references/
tool/
  verify_package.py    Cross-manifest and skill validation

Development

Validate manifests, links, skill metadata, and optional CLI compatibility:

python3 tool/verify_package.py
CODE_BUSTER_EXECUTABLE=/path/to/cb python3 tool/verify_package.py

Check formatting and skill discovery:

npx prettier --check README.md AGENTS.md skills .agents .claude-plugin .codex-plugin .cursor-plugin .devin-plugin .github/plugin .grok-plugin .kimi-plugin gemini-extension.json package.json
npx skills list

Versioning

The agent package and Code Buster CLI have independent versions. Package 0.1.x currently supports Code Buster >=0.7.1. Compatibility changes must update the skill frontmatter, every versioned manifest, README, and validator together.

License

MIT