shipeeet

A composable task management CLI backed by GitHub Issues. Tasks live in GitHub — the CLI is a fast interface to create, track, and sync them.

Requires gh CLI installed and authenticated (gh auth login). First shp run walks you through setup automatically.

Install

npm install -g shipeeet

Usage

shp "Fix login bug"     # opens GitHub pre-filled, waits for submit
shp "Add dark mode" -p P1
shp "Task" --no-open    # local only
shp                     # interactive prompts

States

TODO → WIP → IN REVIEW → SHIPPED
        ↕         ↕
      BLOCKED ←───┘

shp start 5    # → WIP        alias: wip
shp review 5   # → IN REVIEW  alias: rvw
shp block 5    # → BLOCKED    alias: blk
shp ship 5     # → SHIPPED    alias: shp

Assign

shp assign 5           # assign to yourself
shp assign 5 @claude   # assign to someone else
shp a 5                # alias

View & Update

shp ls                  # list active tasks
shp show 5              # task details
shp sheet               # table view
shp 5                   # interactive update
shp update 5 --pr 123   # link a PR
shp open 5              # open GitHub issue in browser (alias: o)

Sync

shp sync           # bidirectional — GitHub is source of truth
shp sync --push    # local → GitHub only
shp sync --pull    # GitHub → local only
shp sync --setup   # configure per-project (optional — global default works everywhere)
shp sync --disable # opt this project out of global default

Config

shp config set defaultGitHubRepo owner/repo   # global default repo
shp config set defaultWorker @handle
shp config show
shp reset                                      # wipe data (multi-select)

Priority & Scope

| Priority | Meaning | Scope | Size | |----------|----------|-------|----------| | P0 | Critical | XS | < 1 hour | | P1 | High | S | Half day | | P2 | Medium | M | 1–2 days | | P3 | Low | XL | Week+ |

Agent Integration

cat ~/.shipeeet/projects/<name>/data.json      # fastest — read directly
shp ls --state TODO --assignee-type agent --json

See skill/spec.md for the full agent specification.

Storage

~/.shipeeet/
├── config.json                # global config + project registry
├── workers/data.json          # all workers
└── projects/<name>/
    ├── db.sqlite              # SQLite (queries)
    ├── data.json              # JSON mirror (git-diffable)
    └── github.json            # per-project GitHub config

License

Apache-2.0 © Ahmad Awais