Give your codebase a brain.

v0.0.12

Quick Install

curl -fsSL https://dizz.shitworks.co/install.sh | bash
Important: After installing, run dizz install-skill to enable AI agent discovery. Agents like Claude Code, Cursor, and Gemini CLI can then use dizz automatically.

Dizz

Overview

Every AI coding agent starts cold. It can't tell abandoned experiments from production code, misses TODOs scattered across your files, and trusts docs that went stale the day after they were written.

dizz gives agents a live model of your project instead. It re-derives context directly from your codebase and Git history on every run - surfacing abandoned code, unstable areas, intents, and open TODOs - and distills 141KB of raw state into a 1.8KB read. Your agent gets current, signal-rich orientation in ~450 tokens, so it spends its budget on the task, not on re-discovering the codebase.

No setup. No internet. Won't touch your code.

Features

🧠

Code Intelligence

Reads your Git history and analyzes your code to surface what needs attention. No configuration needed.

🤖

AI Agent Ready

Speaks TON - a token-optimized format AI agents understand instantly. Auto-discovers via dizz install-skill.

âš¡

Millisecond Performance

Enterprise-grade analysis in milliseconds, not minutes. No network calls, no tokens, no cloud.

📊

State Tracking

Tracks every symbol as active, planned, unstable, unused, or abandoned - based on real usage and Git history.

🔒

Immutable Snapshots

Content-addressed project states for perfect version control and historical analysis.

🎯

Intent System

Long-lived project intents separate from throwaway TODOs. Never lose track of why you wrote something.

CLI Commands

dizz init
Initialize dizz in your project directory.
dizz init
dizz log
Full analysis - planned work, unstable areas, unused and abandoned code.
dizz log [-a] [-v] [-d] [--filter <state>]
dizz status
Quick project health snapshot with visual indicators.
dizz status
dizz context
Token-optimized project dump for AI agents (~2 KB). Pipe-delimited, no parser needed.
dizz context [--intents] [--symbols] [--todos]
dizz snapshot
Create immutable, content-addressed state records with delta support.
dizz snapshot [--auto] [--diff] | snapshot list|checkout|prune
dizz intent
Track long-lived project goals separate from throwaway TODOs.
dizz intent add|list|resolve|close
dizz config
Inspect and manage project config - description, instructions, guardrails.
dizz config show|add-instruction|add-guardrail|set-description
dizz graph
Query the derived project knowledge graph - blast radius, traces, coupling.
dizz graph build|stats|query|trace|cochanges|tests|path|scope|ton|dump|visualize
dizz visualize
Interactive 3D web view of the knowledge graph in your browser.
dizz visualize [--port N] [--cochange]
dizz todo
List TODO/FIXME markers found in your codebase.
dizz todo list
dizz install-skill
Auto-detect AI agents and install the dizz skill for automatic discovery.
dizz install-skill [-p <provider>]
dizz list
Show all saved snapshots with timestamps and metadata.
dizz list
dizz resume
Quick context after being away from the project.
dizz resume
dizz ui
Launch (or install) the dizz Terminal UI.
dizz ui
dizz version
Show current version and build information.
dizz version
dizz upgrade
Upgrade to the latest version automatically.
dizz upgrade