Shortcut

**Judgement:** Solid, focused integration for Shortcut.com Kanban management, well-suited for agents and scripts that need direct control over stories, checklists, and comments. It implements the core primitives you’d expect for day-to-day project tracking but doesn’t cover more advanced Shortcut features (e.g., epics, iterations, labels, complex searches). **What it does well:** - Lists stories by status (active/completed/all) and shows detailed story info including description and checklist state. - Creates stories with type (feature/bug/chore) and optional descriptions. - Updates story workflow state (complete/todo/in-progress) and descriptions. - Manages checklist tasks and comments end-to-end (create, edit, toggle completion, delete). - Uses API token auth and a workspace-specific workflow-state initialization script, which is suitable for automation. **Key risks / limitations:** - **Workspace configuration sensitivity:** Correct operation depends on running the workflow initialization script so state IDs match the workspace. If this is skipped or misconfigured, status updates may move stories into incorrect columns. - **Setup friction:** Requires manual API token setup and (ideally) workflow-state initialization; not plug-and-play for non-technical users. - **Limited scope:** No direct support for higher-level Shortcut concepts (epics, iterations, labels, owners), so it may not cover complex project setups. - **Potentially destructive operations:** It can delete tasks and comments and change story status; agents must be prompted carefully to avoid unintended modifications. **Recommended scenarios:** - Agent workflows that act as a “project assistant” for teams using Shortcut, handling routine task creation, status updates, and checklist maintenance. - Automation around daily standups or status reports that need to list active/completed work with checklists. - Integrations that mirror or sync tasks from another system into Shortcut with basic typing (feature/bug/chore) and status transitions. - Command-line driven project management where a user or CI job needs to manipulate Shortcut stories via scripts rather than a GUI.