ShapeUp CLI

Built for teams. Ready for agents.

~/Code/my-app

1. Install

gem install shapeup-cli

Zero dependencies. Pure Ruby. Works on macOS, Linux, and Windows.

2. Just ask

Run the setup command for your agent in a terminal. It handles login, configuration, and skill installation in one step. Then just talk in plain English - your agent handles the CLI calls behind the scenes.

Claude Code

shapeup setup claude

Cursor

shapeup setup cursor

> triage the latest issue and assign it to me

> create a pitch for the search redesign with a 2-week appetite

> what's left on the Authentication scope?

> move issue #142 to Doing and start working on it

> add a comment on issue #142 linking to PR #87

> show me everything assigned to me this cycle

3. Commands

You don't need to memorise these - your agent already knows them. But they're great for scripting, CI pipelines, or if you prefer working directly from the terminal.

If you just want the CLI without the agent setup, log in and set your default organisation:

shapeup login
shapeup config set org "Your Organisation"

Pitches

shapeup pitches list
shapeup pitch <id>

Cycles

shapeup cycles
shapeup cycle show <id>

Scopes

shapeup scopes list --pitch <id>
shapeup scopes create --pitch <id> "Title"
shapeup scopes update <id> --title "New title"

Tasks

shapeup tasks list --scope <id>
shapeup todo "Description" --pitch <id>
shapeup done <id> [<id>...]

Issues

shapeup issues
shapeup issues --column triage
shapeup issues --assignee me
shapeup issues --tag seo
shapeup issues --kind bug
shapeup issue <id>
shapeup issues create "Title" --stream "Name"
shapeup issues move <id> --column doing
shapeup issues done <id>
shapeup issues close <id>
shapeup issues reopen <id>
shapeup issues icebox <id>
shapeup issues defrost <id>
shapeup issues assign <id>
shapeup issues unassign <id>
shapeup issues watch <id>
shapeup issues unwatch <id>
shapeup issues delete <id>
shapeup watching

Comments

shapeup comments list --issue <id>
shapeup comments list --pitch <id>
shapeup comments add --issue <id> "Text"
shapeup comments add --pitch <id> "Text"

My Work & Search

shapeup me
shapeup search "query"

Config

shapeup config show
shapeup config set org "Name"
shapeup config init "Name"

Output Modes

--json Full JSON with breadcrumbs
--md Markdown tables
--agent Raw JSON for AI agents
--quiet, -q Same as --agent
--ids-only One ID per line

4. CI / Scripts

API tokens for CI pipelines, GitHub Actions, and headless scripts are coming soon.