Skip to main content

Wizard Central Toolkit (wizard-central-toolkit)

The Sovereign Developer Utilities Fleet & AI Router
Fast, zero-dependency, local-first CLI tools designed for Linux development, system orchestration, and deterministic safety policy execution.

License: Apache 2.0 Validation Suite Python Version

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.


🌟 Fleet Inventory & Command Mapping

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

Wizard Direct Executable Central Alias Primary Functionality & Subcommands
The Wizarding Router wiz wiz Central dispatcher & alias router (banner, codeguard, debug, diff, json, python, read, rust, tmux, todo, write)
Godfather Wizard godfather_wizard wiz godfather_wizard Grand Master fleet supervisor, deterministic task routing, interactive REPL cockpit, and the model codegen suite (/brainstorm, /build, /debug, /diff)
Code Guard Wizard codeguard_wizard wiz codeguard Static security scanner (audit, fix, lang, roster, scan, watch, severity, explain, scaffold)
Debug Wizard debug_wizard wiz debug Diagnosis oracle (trace, locate, classify, hotspot, timeline, imports, suggest, audit, report)
Diff Wizard diff_wizard wiz diff Change-truth doctor (files, dirs, context, summary, word, same, reverse)
JSON Wizard json_wizard wiz json Standalone JSON doctor (validate, pretty, compact, inspect, keys, get, diff, stats, merge)
Python Wizard python_wizard wiz python Standalone Python parser & health auditor (check, outline, imports, complexity, loc, secrets, score)
Read Wizard read_wizard wiz read Read-only policy verb gate (check, verbs, law)
Rust Wizard rust_wizard wiz rust Rust project checker (check, build, run, test, clippy, fmt, doc, clean, law, version)
Tmux Wizard tmux_wizard wiz tmux Sovereign tmux session manager (new, attach, kill, list, census, rename, capture, detach, law, version)
Todo Wizard todo_wizard wiz todo Task management wizard (add, list, done, undo, note, oldest, overdue, stats, export)
Write Wizard write_wizard wiz write Consent 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 10 of them; the other 31 live in the Wizard Central Pro AI Modes Toolkit.

# Wizard Command Where it lives
1 Banner Wizard banner_wizard In this version
2 Bash Wizard bashwiz Not in this version — only in Pro
3 Bootstrap Wizard bootstrapwiz Not in this version — only in Pro
4 Calendar Wizard calendarwiz Not in this version — only in Pro
5 Code Guard Wizard codeguard_wizard In this version
6 Command Line Wizard commandlinewiz Not in this version — only in Pro
7 Daemon Wizard daemonwiz Not in this version — only in Pro
8 Debug Wizard debug_wizard In this version
9 Diff Wizard diff_wizard In this version
10 Doc Wizard docwiz Not in this version — only in Pro
11 Dotfile Wizard dotfilewiz Not in this version — only in Pro
12 Exam Wizard examwiz Not in this version — only in Pro
13 Git Wizard gitwiz Not in this version — only in Pro
14 Grant Wizard grantwiz Not in this version — only in Pro
15 Help Wizard helpwiz Not in this version — only in Pro
16 JSON Wizard json_wizard In this version
17 Knowledge Wizard knowledgewiz Not in this version — only in Pro
18 Manual Wizard manualwiz Not in this version — only in Pro
19 Mapping Wizard mappingwiz Not in this version — only in Pro
20 MCP Wizard mcpwiz Not in this version — only in Pro
21 Mode-Manifesting Wizard mode-manifestingwiz Not in this version — only in Pro
22 Modelfile Wizard modelfilewiz Not in this version — only in Pro
23 Ollama Wizard ollamawiz Not in this version — only in Pro
24 Privacy Wizard privacywiz Not in this version — only in Pro
25 Python Wizard python_wizard In this version
26 Read Wizard read_wizard In this version
27 Repair Wizard repairwiz Not in this version — only in Pro
28 REPL Manager Wizard repl-managerwiz Not in this version — only in Pro
29 Requirements Wizard requirementswiz Not in this version — only in Pro
30 SQL Wizard sqlwiz Not in this version — only in Pro
31 Supreme Wizard supremewiz Not in this version — only in Pro
32 Test-Admission Wizard test-admissionwiz Not in this version — only in Pro
33 Todo Wizard todo_wizard In this version
34 Truthdwiz Wizard truthdwiz Not in this version — only in Pro
35 Truth Wizard truthwiz Not in this version — only in Pro
36 Voice Wizard voicewiz Not in this version — only in Pro
37 Whiteboard Wizard whiteboardwiz Not in this version — only in Pro
38 Write Wizard write_wizard In this version
39 Godfather Wizard godfather_wizard In this version
40 Bonus Wizard (planned) bonuswiz Not in this version — only in Pro
41 Keep Wizard (planned) keepwiz Not 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.

Wizard Name-command Alias
Godfather Wizard godfather_wizard godfatherwiz
Banner Wizard banner_wizard bannerwiz
Code Guard Wizard codeguard_wizard codeguardwiz
Debug Wizard debug_wizard debugwiz
Diff Wizard diff_wizard diffwiz
JSON Wizard json_wizard jsonwiz
Python Wizard python_wizard pythonwiz
Read Wizard read_wizard readwiz
Rust Wizard rust_wizard rustwiz
Tmux Wizard tmux_wizard tmuxwiz
Todo Wizard todo_wizard todowiz
Write Wizard write_wizard writewiz

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

Metadata

Release files for wizard-central-toolkit 0.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for wizard-central-toolkit 0.2.1
File Size Uploaded Provenance Actions
wizard_central_toolkit-0.2.1.tar.gz 194.2 kB Without provenance Details for wizard_central_toolkit-0.2.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for wizard-central-toolkit 0.2.1
File Interpreter ABI Platform Actions
wizard_central_toolkit-0.2.1-py3-none-any.whl Python 3 none any Details for wizard_central_toolkit-0.2.1-py3-none-any.whl

Total release size: 327.8 kB

Release files / wizard_central_toolkit-0.2.1.tar.gz

Download URL wizard_central_toolkit-0.2.1.tar.gz
Size 194.2 kB
Tags Source
SHA-256 checksum
How to use checksums
12a3fd42845653373213343f625bd88be249a22a1b62fd80585696f29226286f
BLAKE2b-256 checksum
How to use checksums
5524573153f3fda56223ae4fed802cfeb170b2aa889345799f47e7c77e77e51e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.5

Release files / wizard_central_toolkit-0.2.1-py3-none-any.whl

Download URL wizard_central_toolkit-0.2.1-py3-none-any.whl
Size 133.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2320d7682ea26f755e56b28875d5e410b925c90c4b205438b75b8a84a60d0917
BLAKE2b-256 checksum
How to use checksums
1c4cfddfe0c4238c93e36d1e71f9f0a9776c782260324ab11006e424e1535ca0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.5

Security for wizard-central-toolkit 0.2.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page