configuring-codebase-wizard

Install hooks, configure storage, and set permissions for Codebase Wizard across runtimes.

1|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/SpillwaveSolutions/codebase-mentor --skill configuring-codebase-wizard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: configuring-codebase-wizard
Source: https://github.com/SpillwaveSolutions/codebase-mentor/tree/main/plugins/codebase-wizard/skills/configuring-codebase-wizard
Command: npx skills add https://github.com/SpillwaveSolutions/codebase-mentor --skill configuring-codebase-wizard

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill provides a one-time onboarding flow to install and configure the Codebase Wizard infrastructure, including Agent Rulez hooks, storage directories, and scoped permissions.

Core Features & Use Cases

  • Install and deploy security hooks (agent-rulez) and session-capture rules for Claude Code, OpenCode, and Gemini, while handling Codex via manual export.
  • Create and persist storage configuration, including {resolved_storage}/config.json and storage directories for sessions/docs.
  • Provide guidance and scripts to perform setup, including writing settings.local.json and running the setup script.

Quick Start

Run the provided setup script with your runtime to install hooks, configure storage, and prepare the wizard for first use.

Frequently Asked Questions about configuring-codebase-wizard

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up agent hooks and storage for AI coding assistants?

Setting up agent hooks involves running a one-time onboarding script that deploys agent-rulez.yaml, creates session storage directories, and configures scoped permissions for your specific AI coding assistant runtime.

Can I configure Codebase Wizard hooks for OpenCode and Gemini workflows?

Yes, you can configure hooks for OpenCode and Gemini workflows. The setup process automatically supports Claude Code, OpenCode, and Gemini, while handling Codex configurations via a manual export process.

What does the settings.local.json configuration file do for codebase agents?

The settings.local.json file enables secure operation for codebase agents by defining scoped permissions and runtime-aware settings generated during the initial setup and configuration process.

Why do I need to run a setup script before using the Codebase Wizard?

You need to run the setup script because it performs the one-time installation of Agent Rulez hooks, writes config.json, and deploys settings.local.json to ensure consistent and secure infrastructure across runtimes.

Does the Codebase Wizard setup support Codex workflows automatically?

No, Codex workflows are not supported automatically by the setup. You must configure Codex through a manual export process after running the primary setup script for other runtimes.