shortcut

# Shortcut Kanban Integration Manage tasks and stories on Shortcut.com project boards via API. ## Prerequisites - Shortcut API token stored at `/root/secrets/shortcut-api-token` - Access to a Shortcut workspace with appropriate permissions ## Available Operations ### List Stories ```bash scripts/shortcut-list-stories.sh [--active|--completed|--all] [--json] ``` Options: - `--active` - Show only incomplete stories (default) - `--completed` - Show only completed stories - `--all` - Include archived stories - `--json` - Output raw JSON ### Create Story ```bash scripts/shortcut-create-story.sh "Story name" [--description "text"] [--type feature|bug|chore] ``` Story types: - `feature` (default) - New functionality - `bug` - Bug fix - `chore` - Maintenance task ### Update Story ```bash scripts/shortcut-update-story.sh <story-id> [--state started|done|unstarted] [--description "new text"] ``` Workflow state IDs vary by workspace. Common defaults: - Unstarted (typically `500000006`) - Started (typically `500000007`) - Done (typically `500000008`) To find your workspace's state IDs, use the Shortcut API or check your board settings. ## Workflow 1. List existing stories to understand current board state 2. Create new stories with descriptive names and appropriate types 3. Update story status as work progresses ## Notes - All scripts require sudo access to read the API token from `/root/secrets/shortcut-api-token` - Stories are created in "Unstarted" state by default (workflow_state_id: 500000006) - If your workspace uses different workflow state IDs, you may need to adjust the scripts - The token must have permissions for the workspace you want to manage