Highlights

This major release introduces full Iterations support, updates Commander with improved TypeScript types, and includes significant infrastructure improvements with the migration to pnpm.

New Commands

short iterations - List and Filter Iterations

List all iterations in your workspace with powerful filtering options.

short iterations [options]

Options:

Examples:

# List all iterations
short iterations

# Show current iterations only
short iterations -C

# Filter by status
short iterations -S started

# Filter by team
short iterations -T Engineering

short iteration - View, Create, Update, Delete Iterations

Full CRUD operations for individual iterations.

Subcommands:

Create Options:

• -n, --name [text] - Set name of iteration (required)
• -d, --description [text] - Set description of iteration
• --start-date [date] - Set start date in YYYY-MM-DD format (required)
• --end-date [date] - Set end date in YYYY-MM-DD format (required)
• -T, --team [id|name] - Set team/group of iteration
• -I, --idonly - Print only ID of iteration result
• -O, --open - Open iteration in browser

Update Options:

• -n, --name [text] - Set name of iteration
• -d, --description [text] - Set description of iteration
• --start-date [date] - Set start date in YYYY-MM-DD format
• --end-date [date] - Set end date in YYYY-MM-DD format
• -T, --team [id|name] - Set team/group of iteration
• -O, --open - Open iteration in browser

Stories Options:

• -f, --format [template] - Format each story output by template

Examples:

# View an iteration
short iteration view 123

# Create a new iteration
short iteration create -n "Sprint 1" --start-date 2026-01-13 --end-date 2026-01-27 -T Engineering

# Update an iteration
short iteration update 123 -n "Sprint 1 - Extended" --end-date 2026-01-31

# Delete an iteration
short iteration delete 123

# List stories in an iteration
short iteration stories 123

Infrastructure Changes

• Updated commander and improved types by @charpeni in #361
• Migrated to pnpm by @charpeni in #362
• Updated dependencies by @charpeni in #363
• Updated tsdown to 0.19.0 by @charpeni in #364

Full Changelog: v3.8.1...v4.0.0

Bug Fixes

Fix story comment creation

Fixed an issue where adding comments to stories via short story <id> --comment was failing. (by @charpeni in #360)

Root cause: The createStoryComment API expects an object with a text property ({ text: "comment" }), but the CLI was incorrectly passing a raw string.

Affected command:

short story 12345 --comment "My comment"

This command now works correctly again.

Full Changelog: v3.8.0...v3.8.1

Highlights

This release introduces two major new command families - Epic Create and Docs - along with an updated Shortcut client library.

New Commands

short epic create - Create Epics from CLI (by @adamnbowen in #356)

Previously, the CLI could only list epics (short epics). Now you can create new epics directly from the command line.

short epic create [options]

Options:

Examples:

# Create a simple epic
short epic create -n "API Redesign Project"

# Create with description and state
short epic create -n "Q1 Platform Work" -d "Infrastructure improvements" -s "in progress"

# Create with deadline and owners
short epic create -n "Mobile Launch" --deadline 2024-06-30 -o alice,bob

# Create with team and labels
short epic create -n "Security Audit" -T Engineering -l security,compliance

# Create and open in browser
short epic create -n "Documentation Sprint" -O

short docs - List and Search Docs (by @charpeni in #359)

New command to list and search Shortcut Docs (alias: short d).

short docs [options]

Options:

Examples:

# List all docs
short docs

# Search docs by title
short docs -t "meeting notes"

short doc - View, Create, Update, and Delete Docs (by @charpeni in #359)

Full CRUD operations for individual Shortcut Docs.

Subcommands:

Create Options:

• -t, --title [text] - Document title (required)
• -c, --content [text] - Document content
• --markdown - Parse content as Markdown

Update Options:

• -t, --title [text] - New title
• -c, --content [text] - New content
• --markdown - Parse content as Markdown

Examples:

# View a doc
short doc view abc-123-uuid
short doc abc-123-uuid  # shorthand

# Create a doc with markdown
short doc create -t "My Doc" -c "# Hello" --markdown

# Update a doc
short doc update abc-123-uuid -t "New Title"

# Delete a doc
short doc delete abc-123-uuid --confirm

Dependencies

• Updated @shortcut/client from 2.3.1 to 3.1.0 - Brings the latest Shortcut API improvements and fixes. (by @charpeni in #358)

Full Changelog: v3.7.0...v3.8.0

What's Changed

• fix: use storyURL helper in search command to include workspace slug by @adamnbowen in #352
• feat: add --team option to update story team/group by @adamnbowen in #353
• Fixed reading SHORTCUT_API_TOKEN and added two new ENV vars. by @digerata in #349
• Update dependencies by @charpeni in #354
• Update GitHub Actions by @charpeni in #355

New Contributors

• @adamnbowen made their first contribution in #352
• @digerata made their first contribution in #349

Full Changelog: v3.6.0...v3.7.0

Notable Changes

@akirayamamoto identified an issue (#343) where we were unable to use lookup by name for entities and resolved it in #344. Thank you!

What's Changed

• Bump form-data from 4.0.3 to 4.0.4 by @dependabot[bot] in #342
• Fix Map iteration bugs in findOwnerIds and findEntity by @akirayamamoto in #344
• Configure publish package via OIDC by @charpeni in #345
• Update actions/checkout from 4.2.2 to 5.0.0 by @charpeni in #346

New Contributors

• @akirayamamoto made their first contribution in #344

Full Changelog: v3.5.0...v3.6.0

What's Changed

• Add api command by @pedroni in #338
• Use tsdown instead of tsup to achieve a smaller footprint by @charpeni in #340
• Update dependencies by @charpeni in #341

New Contributors

• @pedroni made their first contribution in #338

Full Changelog: v3.4.0...v3.5.0

What's Changed

• @shortcut/client version has been updated
• Updated axios to resolve a CVE
• This CLI is now bundled via tsup rather than transpiled with tsc

Full Changelog: v3.3.0...v3.4.0