Shortcut Kanban Integration

---

name: shortcut

version: 1.4.1

description: Manage stories on Shortcut.com kanban boards. Use when creating, updating, or listing tasks/stories on Shortcut project management boards. Supports creating stories with descriptions and types (feature/bug/chore), updating story status, and listing active/completed stories. Includes full checklist task management and comment support.

---

# Shortcut Kanban Integration

Manage tasks and stories on Shortcut.com project boards via API.

Prerequisites

- Environment variable: `SHORTCUT_API_TOKEN`

- File: `~/.config/shortcut/api-token`

Setup

1. Get your API token from Shortcut.com (Settings → API Tokens)

2. Store it either:

- As environment variable: `export SHORTCUT_API_TOKEN="your-token"`

- In a file: `echo "your-token" > ~/.config/shortcut/api-token && chmod 600 ~/.config/shortcut/api-token`

3. Initialize workflow states for your workspace:

```bash

scripts/shortcut-init-workflow.sh

```

This creates `~/.config/shortcut/workflow-states` with your workspace's actual state IDs.

4. Optionally add to `~/.bashrc` for persistence:

```bash

export SHORTCUT_API_TOKEN=$(cat ~/.config/shortcut/api-token 2>/dev/null | tr -d '\n')

source ~/.config/shortcut/workflow-states

```

Available Operations

List Stories

scripts/shortcut-list-stories.sh [--active|--completed|--all] [--json]

Options:

Show Story Details

scripts/shortcut-show-story.sh <story-id>

Displays full story information including:

Create Story

scripts/shortcut-create-story.sh "Story name" [--description "text"] [--type feature|bug|chore]

Story types:

Update Story

scripts/shortcut-update-story.sh <story-id> [--complete|--todo|--in-progress] [--description "new text"]

**Workflow states:** The script uses state IDs from `~/.config/shortcut/workflow-states` (created by `shortcut-init-workflow.sh`). If not configured, it falls back to common defaults:

**Note:** Different Shortcut workspaces may use different state IDs. Always run `shortcut-init-workflow.sh` to configure your workspace's actual IDs.

Manage Checklist Tasks

**Create a task:**

scripts/shortcut-create-task.sh <story-id> "task description"

**Update task completion status:**

scripts/shortcut-update-task.sh <story-id> <task-id> [--complete|--incomplete]

**Edit task description:**

scripts/shortcut-edit-task.sh <story-id> <task-id> "new description"

**Delete a task:**

scripts/shortcut-delete-task.sh <story-id> <task-id>

Use `shortcut-show-story.sh` to see task IDs.

Manage Comments

**Add a comment:**

scripts/shortcut-add-comment.sh <story-id> "comment text"

**Update a comment:**

scripts/shortcut-update-comment.sh <story-id> <comment-id> "new text"

**Delete a comment:**

scripts/shortcut-delete-comment.sh <story-id> <comment-id>

Use `shortcut-show-story.sh` to see comment IDs.

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