sc-scripts

Simple CLI for Shortcut project management.

Installation

Using npm

npm install -g @movable/sc-scripts

Using Yarn

yarn global add @movable/sc-scripts

Using Volta

volta install @movable/sc-scripts

From source

git clone https://github.com/movableink/sc-scripts.git
cd sc-scripts
yarn install
yarn link

Setup

Before using the CLI, you need to authenticate with your Shortcut API token:

sc auth

You'll be prompted to enter your Shortcut API token. You can find your API token at: https://app.shortcut.com/settings/account/api-tokens

The token is stored securely in ~/.config/sc/auth with read-only permissions for your user.

Usage

List teams/groups

Show all teams with their IDs and associated workflows:

sc teams
# or
sc groups

List projects

Show all projects with their IDs:

sc projects

List workflows

Show all workflows with their IDs:

sc workflows

Search stories

Search for stories by keyword:

sc stories "search term"

For LLM Users

Add the following to your project's CLAUDE.md file to help Claude understand how to use Shortcut in your workflow:

## Shortcut Integration

This project uses the `sc` CLI tool for Shortcut integration. Available commands:

- `sc stories "keyword"` - Search for stories related to a keyword
- `sc teams` - List all teams with their workflow IDs
- `sc projects` - List all projects
- `sc workflows` - List all workflows

For anything else, use the Shortcut MCP server if available.

Development

Prerequisites

• Node.js >= 20
• Yarn

Setup

yarn install

Run locally

./sc.js [command]
# or
node sc.js [command]

Install locally for development

yarn link

License

MIT