codebase-wizard

v1.4.0

Wizard-style codebase exploration, documentation, and Q&A with auto-captured sessions.

CodexClaude CodeAgent Plugins3 Skills

By Rick HightowerLicense: MIT1 GitHub starsUpdated 2 months ago

Directory evidence

Runtimes: Codex, Claude Code, and Agent Plugins
Parsed components: 3 skill or MCP entries
Source updated: Aug 22, 2026
Manifest status: Canonical path parsed

The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →

Install codebase-wizard for Codex and Claude Code

Installs for the current user

claude plugin marketplace add IchenDEV/agent-plugin-mkt
claude plugin marketplace update agent-plugin-marketplace
claude plugin install codebase-wizard-3@agent-plugin-marketplace

Paste and run these commands in a terminal with Claude Code. They add and refresh the PluginsMP catalog, then install this plugin.

Compatibility: the page URL and API slug “codebase-wizard-3” remain stable.

Codex: Legacy selector codebase-wizard-3@agent-plugin-marketplace remains documented for migration; install from source for this runtime.

The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.

Codex has another source with the same manifest name. This directory does not invent numbered install aliases; use the publisher's catalog or inspect the source manually for that runtime.

Get the source manually

$ git clone https://github.com/SpillwaveSolutions/codebase-mentor

Clone the source repository, then follow its setup instructions to add the plugin to a compatible client. The plugin root is plugins/codebase-wizard/.

Plugin files

plugins/codebase-wizard/

├── .codex-plugin/plugin.json
├── .claude-plugin/plugin.json
├── plugin.json
├── skills/configuring-codebase-wizard/SKILL.md
├── skills/explaining-codebase/SKILL.md
└── skills/exporting-conversation/SKILL.md

Included Skills3

configuring-codebase-wizardskills/configuring-codebase-wizard/SKILL.md

One-time setup for the Codebase Wizard. Use when the user runs /codebase-wizard-setup, says "set up the wizard", "install wizard", or "configure codebase wizard". Installs Agent Rulez hooks, creates storage directories, writes config.json, and sets scoped write permissions.

explaining-codebaseskills/explaining-codebase/SKILL.md

Universal explainer for codebases, specs, design docs, and markdown files. Activates when a user wants to understand how their code works, explore a new codebase, document an existing one, or get walked through any markdown artifact (specs, roadmaps, design docs, milestone plans). Trigger on: "explain this codebase", "walk me through this", "describe this code", "I'm new to this repo", "how does X work", "what calls this", "where does this get used", "explain this spec", "walk me through this roadmap", "what does this milestone mean", "explain this design doc", "--describe", "--explore", "--file <path>". Also triggers when user pastes code or a markdown file and asks questions about it — treat as a micro-artifact. Produces (written to {resolved_storage}/docs/{session_id}/): - SESSION-TRANSCRIPT.md (all modes — always generated) - CODEBASE.md (describe mode) - TOUR.md (explore mode) - FILE-NOTES.md (file mode)

exporting-conversationskills/exporting-conversation/SKILL.md

Synthesizes raw wizard session JSON into structured documentation. Use when the user runs /codebase-wizard-export, says "export session", "generate docs", "create CODEBASE.md", or "turn the session into docs".

Plugin manifests3

plugins/codebase-wizard/.codex-plugin/plugin.json

{
  "name": "codebase-wizard",
  "version": "1.4.0",
  "description": "Wizard-style codebase exploration, documentation, and Q&A with auto-captured sessions.",
  "author": {
    "name": "Rick Hightower",
    "url": "https://github.com/RichardHightower"
  },
  "homepage": "https://github.com/SpillwaveSolutions/codebase-mentor",
  "repository": "https://github.com/SpillwaveSolutions/codebase-mentor",
  "license": "MIT",
  "keywords": [
    "claude-code",
    "grok-build",
    "codex",
    "cursor",
    "agent-plugins",
    "worklog",
    "wiki-ticket-sdd"
  ],
  "skills": "./skills/"
}

plugins/codebase-wizard/.claude-plugin/plugin.json

{
  "name": "codebase-wizard",
  "version": "1.4.0",
  "description": "Wizard-style codebase explainer and documentation generator. Accepts any codebase, spec, or markdown artifact and explains it through conversational Q&A — with code-block anchors, plain-English explanations, and follow-up predictions. Two modes: Describe (repo owner documents their codebase) and Explore (new developer gets a learning-order tour). Sessions auto-captured and synthesizable as CODEBASE.md or TOUR.md.",
  "keywords": [
    "codebase",
    "documentation",
    "exploration",
    "wizard",
    "explain",
    "tour",
    "ai-codebase-mentor"
  ],
  "author": {
    "name": "Spillwave Solutions",
    "url": "https://github.com/SpillwaveSolutions"
  },
  "license": "MIT",
  "homepage": "https://github.com/SpillwaveSolutions/codebase-mentor",
  "repository": "https://github.com/SpillwaveSolutions/codebase-mentor"
}

plugins/codebase-wizard/plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "codebase-wizard",
  "version": "1.4.0",
  "description": "Wizard-style codebase exploration, documentation, and Q&A with auto-captured sessions.",
  "author": {
    "name": "Rick Hightower",
    "url": "https://github.com/RichardHightower"
  },
  "homepage": "https://github.com/SpillwaveSolutions/codebase-mentor",
  "repository": "https://github.com/SpillwaveSolutions/codebase-mentor",
  "license": "MIT",
  "keywords": [
    "claude-code",
    "grok-build",
    "codex",
    "cursor",
    "agent-plugins",
    "worklog",
    "wiki-ticket-sdd"
  ],
  "skills": "./skills/"
}