MathSphere Nexus official corporate seal MathSphere Nexus

Wizard Central Toolkit — README

Version 0.2.8 — the README as published in the project's repository

Wizard Central Toolkit (wizard-central-toolkit)

The Sovereign Developer Utilities Fleet & AI Router
Fast, local-first CLI tools built on the Python standard library, plus two small display libraries, designed for Linux development, system orchestration, and deterministic safety policy execution.

License: Apache 2.0 — Validation suite: 13/13 passed — Python 3.10+.

wizard-central-toolkit is a production-grade suite of 12 developer utilities that run locally with minimal overhead and deterministic output. Designed to operate standalone as individual CLI binaries or orchestrated through the Godfather Wizard and the Wizarding Router (wiz), every tool in this repository is fully functional, disk-verified, and CI-tested.

Every command, documented: COMMANDS.md lists all 13 primary commands — 25 entry points counting the 12 aliases — and 147 subcommands, each with what it does.

See it run: DEMO.md is the demo section — every feature tested live and documented from the real runs, from install check through the consent wall to the model codegen suite.

Release history

Full changelog is in CHANGELOG.md.

0.2.8 — 2026-11-10

0.2.7 — 2026-11-10

0.2.6 — 2026-11-10

0.2.5 — 2026-11-10

0.2.4 — 2026-11-10

0.2.3 — 2026-11-10

0.2.2 — 2026-11-10

0.2.1 — 2026-11-10

0.2.0 — earlier

Fleet inventory & command mapping

All 12 wizard modules on disk are active, registered, and disk-verified:

WizardDirect ExecutableCentral AliasPrimary Functionality & Subcommands
The Wizarding RouterwizwizCentral dispatcher & alias router (banner, codeguard, debug, diff, json, python, read, rust, tmux, todo, write)
Godfather Wizardgodfather_wizardwiz godfather_wizardGrand Master fleet supervisor, deterministic task routing, interactive REPL cockpit, and the model codegen suite (/brainstorm, /build, /debug, /diff)
Code Guard Wizardcodeguard_wizardwiz codeguardStatic security scanner (audit, fix, lang, roster, scan, watch, severity, explain, scaffold)
Debug Wizarddebug_wizardwiz debugDiagnosis oracle (trace, locate, classify, hotspot, timeline, imports, suggest, audit, report)
Diff Wizarddiff_wizardwiz diffChange-truth doctor (files, dirs, context, summary, word, same, reverse)
JSON Wizardjson_wizardwiz jsonStandalone JSON doctor (validate, pretty, compact, inspect, keys, get, diff, stats, merge)
Python Wizardpython_wizardwiz pythonStandalone Python parser & health auditor (check, outline, imports, complexity, loc, secrets, score)
Read Wizardread_wizardwiz readRead-only policy verb gate (check, verbs, law)
Rust Wizardrust_wizardwiz rustRust project checker (check, build, run, test, clippy, fmt, doc, clean, law, version)
Tmux Wizardtmux_wizardwiz tmuxSovereign tmux session manager (new, attach, kill, list, census, rename, capture, detach, law, version)
Todo Wizardtodo_wizardwiz todoTask management wizard (add, list, done, undo, note, oldest, overdue, stats, export)
Write Wizardwrite_wizardwiz writeConsent wall for file writes (propose, preview, commit, verify, rollback, protect, backups)

Usage examples

1. The Wizarding Router (wiz) and the Godfather Wizard (godfather_wizard)

Execute sub-tools via wiz or inspect fleet state with godfather_wizard:

# Execute sub-tools via alias
wiz todo add "Refactor logger module"
wiz json validate config.json

# Godfather Wizard fleet supervision
godfather_wizard census
godfather_wizard status
godfather_wizard repl

Inside the REPL, the model-only codegen suite offers /brainstorm (hands-off conversation), /build and /debug (complete-content proposals shown as diffs and landed only after the double ask, through the Write Wizard), and /diff (review-only proposals). Per-task models are optional: godfather_wizard models shows the roster and assignments, and godfather_wizard models set <task> <model> stores them in ~/.godfather/models.json.

Six providers can seat a model. Ollama is the local seat — no key, nothing leaves your machine. The other five (Meta (Muse), Anthropic, OpenAI, Google, and DeepSeek) are cloud seats you opt into with your own API key, read from your environment at call time; a seat is assigned as provider:model (for example anthropic:claude-sonnet-4-5). The toolkit stays local-first: nothing is sent anywhere unless you seat a cloud provider — and when you do, the prompts and, for /build, /debug, and /diff, the file contents involved go to that provider over HTTPS. Keys are never stored in the toolkit, never journaled, and never printed; godfather_wizard models reports only whether a key is set. PROVIDERS.md is the setup guide: where to get each provider's key, and how to install Ollama and pull your first local models.

Wizard Central Pro AI Modes Toolkit — still in the making

This free toolkit is the sampler: twelve local-first wizards under Apache 2.0, yours to use and build on.

Not in the sampler: the Truth Wizard, the Repair Wizard, the Ollama Wizard, the Whiteboard Wizard, the Manual Wizard, and the Boot Wizard. They are part of the Wizard Central Pro AI Modes Toolkit, still in the making: a fleet growing toward 41 wizards; 70 AI modes that advise; 23 guard modes that bind; seat cards that cast; creations of nine kinds — wizards, AI modes, tools, skills, tasks, guard modes, scripts, seat cards, and projects; a sealed locker (CVLT Arbiter) for a person's own creations; and a gated bridge that opens only by a person's yes, asked twice — and every crossing generates a receipt.

Pro is not released, and there is no signup yet. When it is ready, this page will say where to find it.

The full roster — all 41 wizards

Wizard Central's fleet counts 41 wizards. This sampler ships 12 wizards — 10 of them from that roster; the other 31 roster wizards live in the Wizard Central Pro AI Modes Toolkit, and the Tmux and Rust Wizards live only here.

#WizardCommandWhere it lives
1Banner Wizardbanner_wizardIn this version
2Bash WizardbashwizNot in this version — only in Pro
3Bootstrap WizardbootstrapwizNot in this version — only in Pro
4Calendar WizardcalendarwizNot in this version — only in Pro
5Code Guard Wizardcodeguard_wizardIn this version
6Command Line WizardcommandlinewizNot in this version — only in Pro
7Daemon WizarddaemonwizNot in this version — only in Pro
8Debug Wizarddebug_wizardIn this version
9Diff Wizarddiff_wizardIn this version
10Doc WizarddocwizNot in this version — only in Pro
11Dotfile WizarddotfilewizNot in this version — only in Pro
12Exam WizardexamwizNot in this version — only in Pro
13Git WizardgitwizNot in this version — only in Pro
14Grant WizardgrantwizNot in this version — only in Pro
15Help WizardhelpwizNot in this version — only in Pro
16JSON Wizardjson_wizardIn this version
17Knowledge WizardknowledgewizNot in this version — only in Pro
18Manual WizardmanualwizNot in this version — only in Pro
19Mapping WizardmappingwizNot in this version — only in Pro
20MCP WizardmcpwizNot in this version — only in Pro
21Mode-Manifesting Wizardmode-manifestingwizNot in this version — only in Pro
22Modelfile WizardmodelfilewizNot in this version — only in Pro
23Ollama WizardollamawizNot in this version — only in Pro
24Privacy WizardprivacywizNot in this version — only in Pro
25Python Wizardpython_wizardIn this version
26Read Wizardread_wizardIn this version
27Repair WizardrepairwizNot in this version — only in Pro
28REPL Manager Wizardrepl-managerwizNot in this version — only in Pro
29Requirements WizardrequirementswizNot in this version — only in Pro
30SQL WizardsqlwizNot in this version — only in Pro
31Supreme WizardsupremewizNot in this version — only in Pro
32Test-Admission Wizardtest-admissionwizNot in this version — only in Pro
33Todo Wizardtodo_wizardIn this version
34Truthdwiz WizardtruthdwizNot in this version — only in Pro
35Truth WizardtruthwizNot in this version — only in Pro
36Voice WizardvoicewizNot in this version — only in Pro
37Whiteboard WizardwhiteboardwizNot in this version — only in Pro
38Write Wizardwrite_wizardIn this version
39Godfather Wizardgodfather_wizardIn this version
40Bonus Wizard (planned)bonuswizNot in this version — only in Pro
41Keep Wizard (planned)keepwizNot in this version — only in Pro

Two of this sampler's own citizens do not appear on the roster. Tmux Wizard (tmux_wizard) — in Pro, its session features are absorbed into the Daemon Wizard's family, as an opt-in feature. Rust Wizard (rust_wizard) — discontinued in the Pro version; it ships in this free toolkit only.

Names and aliases

A wizard's name-command is its full underscored form — that is how each wizard is called by its whole name. The short form is an alias: installed, fully working, and interchangeable with the full form in every surface (same output, same exit codes). The router's full name is the Wizarding Router; its command is wiz.

WizardName-commandAlias
Godfather Wizardgodfather_wizardgodfatherwiz
Banner Wizardbanner_wizardbannerwiz
Code Guard Wizardcodeguard_wizardcodeguardwiz
Debug Wizarddebug_wizarddebugwiz
Diff Wizarddiff_wizarddiffwiz
JSON Wizardjson_wizardjsonwiz
Python Wizardpython_wizardpythonwiz
Read Wizardread_wizardreadwiz
Rust Wizardrust_wizardrustwiz
Tmux Wizardtmux_wizardtmuxwiz
Todo Wizardtodo_wizardtodowiz
Write Wizardwrite_wizardwritewiz

A command is what you type. The name is what the project is.

This is the project's README as published in its repository at version 0.2.8. The repository itself is at github.com/rewardsbycode-eng/wizard-central-toolkit.

MathSphere Nexus official corporate seal