dizz

Know what to work on next.

dizz is a local, Git-aware developer CLI that analyzes your codebase and answers one core question:

“What should I work on next?”

Unlike linters or task trackers, dizz focuses on developer understanding — not just correctness.

dizz is stable and safe to use on real projects.
It runs fully offline, makes no network calls, never modifies your code, and operates in read-only mode.

Contents

• Overview
• Why dizz?
• What dizz is not
• Installation
• Quick Start
• Commands
• Symbol States
• License

Overview

dizz is a local, Git-aware developer CLI that analyzes your codebase to understand progress, not just correctness.
It helps developers answer the question “What should I work on next?” by detecting unused code, planned work (TODOs), unstable areas, and forgotten or abandoned logic using static analysis and Git context.

Unlike linters or task managers, dizz models developer intent and code evolution. It runs fully offline, requires no configuration to start, and works across multiple languages through a unified, signal-based architecture that separates language parsing from state interpretation.

Why dizz?

Git tracks truth. dizz tracks understanding.

Modern projects fail not because of bugs, but because of:

• Lost context
• Forgotten TODOs
• Unused or half-connected code
• Unclear priorities after time away

dizz continuously models your project’s state of progress and surfaces what actually deserves your attention.

What dizz is not

• Not a linter
• Not a task manager
• Not an AI agent that edits your code or executes changes autonomously

Installation

Linux & macOS

curl -fsSL https://dizz.shitworks.co/install.sh | bash

Windows

powershell -c "irm https://dizz.shitworks.co/install.ps1 | iex"

After installation, restart your shell and verify it using:

dizz version

Quick Start

cd your-project
dizz init
dizz status
dizz log

Commands

dizz init

Initializes .dizz/ metadata in your project.

dizz log

Full project analysis.

Shows:

• Planned work
• Unstable areas
• Unused code
• Abandoned code

Flags

• --all, -a — include healthy symbols
• --verbose, -v — detailed reasoning

Internally, this command builds a project-wide state graph from static analysis signals and Git metadata.

dizz status

Quick health snapshot with visual indicators.

dizz snapshot

Creates an immutable snapshot of project state.

• Content-addressed (Git-like)
• Stored in .dizz/objects/

Flags:

• --auto — for Git hooks

dizz list

Shows snapshot history and project evolution.

dizz resume

Instant context recovery after time away.

Optimized for:

“I haven’t touched this project in weeks.”

dizz intent

Manage human-authored intent.

dizz separates intent from implementation: comment-based TODO/FIXME markers track disposable code fixes, while immutable Intents record long-lived project goals (todo, refactor, fixme, question, hack, temporary) that persist as part of the project’s evolving narrative.

Add an intent

dizz intent add "Refactor auth layer" --severity 2 --type todo

List all intents

dizz intent list

Resolve and intent (mark it completed)

dizz intent resolve int_1770020361

Each Intent carries a severity score from 0–3, where 3 represents critical, project-shaping intent and 0 represents low-impact or exploratory intent.

Intents are immutable project goals; TODO/FIXME comments are mutable code-level fixes — dizz treats them differently by design.

Symbol States

Symbol states are derived by combining usage signals, intent markers, and historical Git churn.

State	Meaning
active	Used and stable
planned	Has TODO / intent
unstable	High churn
unused	Declared, never used
abandoned	Old + unused

License

LICENSE

Built with ❤️ for developers who hate wasting time deciding what to work on next.