Skip to content
Get Shit Done

/gsd inspect

A debugging tool that exposes the internal state of GSD’s SQLite database. Use it when project state seems wrong, checkboxes are out of sync, or you need to understand what the database actually contains.

Usage

Section titled “Usage”
/gsd inspect

What It Shows

Section titled “What It Shows”
  • Schema information — tables, columns, and indexes in the GSD database
  • Row counts — how many records exist in each table (milestones, slices, tasks, decisions, etc.)
  • Recent entries — the most recent rows from key tables

This is a read-only diagnostic. It doesn’t modify any state.

When to Use

Section titled “When to Use”
  • A task shows as complete in the database but the markdown checkbox is unchecked (or vice versa)
  • /gsd status shows unexpected state
  • You suspect data corruption after a crash or interrupted operation
  • You want to understand what GSD tracks internally
Section titled “Related Commands”
  • /gsd doctor — broader diagnostic checks beyond just the database
  • /gsd logs — view execution logs rather than database state