State Management

DubStack stores all state locally in your repository under .git/dubstack/.

State Files

• state.json — Branch tracking relationships (parent/child graph)
• state.sqlite — Optional SQLite-backed branch tracking state for large repositories
• undo-log.json — Multi-level undo ring buffer (20 entries)
• redo-log.json — Redo ring populated when dub undo runs; cleared on the next new mutation
• restack-progress.json — In-progress rebase/restack state for recovery

state.json is the default. See SQLite Backend to opt in to SQLite storage.

State Recovery

If state becomes corrupted or out of sync, use dub doctor to diagnose and repair issues.

No Cloud Dependency

All state is local to your git repository. There's no external service to authenticate with or depend on.