ninja-rebuild

Rebuild the SQLite menu cache from YAML metadata files.

Updated Jan 27, 2026
One-click install
npx skills add https://github.com/alistairhendersoninfo/ninja_toolbox --skill ninja-rebuild
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ninja-rebuild
Source: https://github.com/alistairhendersoninfo/ninja_toolbox/tree/main/.claude/skills/ninja-rebuild
Command: npx skills add https://github.com/alistairhendersoninfo/ninja_toolbox --skill ninja-rebuild

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Rebuilds the SQLite menu cache from YAML metadata files to keep the NinjaMenu in sync with the available scripts and their configurations. When scripts are added, removed, or renamed, stale cache data can lead to broken menus or incorrect status indicators; this Skill ensures the menu reflects the current catalog.

Core Features & Use Cases

  • Rebuilds the SQLite menu cache from YAML metadata files.
  • Optional per-script installation checks with --check-installed to refresh statuses.
  • Produces a summary of how many scripts and submenus were cached.

Quick Start

Run the ninja-rebuild command to refresh the SQLite menu cache from YAML metadata.

Frequently Asked Questions about ninja-rebuild

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

FAQPage Schema
How do I rebuild a SQLite menu cache from YAML metadata?

Rebuilding a SQLite menu cache from YAML metadata involves running a rebuild command that activates a Python virtual environment and executes menu.py --rebuild to synchronize the cache with updated script configurations.

Why does my menu structure show stale data or broken links after updating scripts?

Stale data or broken links in your menu structure appear when YAML metadata changes are not synced to the SQLite cache. Rebuilding the cache refreshes the available scripts and submenus to accurately reflect the current catalog.

Can I check if individual scripts are installed while rebuilding the menu cache?

Yes, you can check individual script installations during a menu cache rebuild by passing the --check-installed flag. This runs per-script installation checks and reports the total scripts and submenus cached.

What is a SQLite menu cache and when does it need rebuilding?

A SQLite menu cache stores menu structure and script configurations from YAML files for quick access. It needs rebuilding when scripts are added, removed, or renamed, ensuring the menu reflects the current catalog without stale data.

Do I need a Python virtual environment to rebuild the menu cache?

Yes, a Python virtual environment is required to rebuild the menu cache. The rebuild process automatically activates the virtual environment before running menu.py to generate the SQLite cache from YAML metadata.

How can I verify how many scripts and submenus were cached after a menu rebuild?

To verify how many scripts and submenus were cached after a menu rebuild, check the summary output produced by the rebuild command. It reports the total scripts and submenus cached in the SQLite database.