Give your codebase a brain.

v0.0.8

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

dizz reads your Git history, looks at your code, and tells you what needs doing. TODOs, half-finished work, things changing too often — it tracks all of it. Takes snapshots so you never lose context. Agents love it because it speaks their language.

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 [--all] [--verbose]
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]
dizz intent
Track long-lived project goals separate from throwaway TODOs.
dizz intent add|list|resolve
dizz install-skill
Auto-detect AI agents and install the dizz skill for automatic discovery.
dizz install-skill
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 version
Show current version and build information.
dizz version [--verbose]
dizz upgrade
Upgrade to the latest version automatically.
dizz upgrade