Quickstart

1) Install

npm i -g blocpad-cli
blocpad --help

Or run without installing:

npx blocpad-cli --help

2) Create a token

Create a Personal Access Token (PAT) in BlocPad. The token value looks like bp_pat_....

Go to https://www.blocpad.com
Open Settings: https://www.blocpad.com/settings
Create a new Personal Access Token and copy the bp_pat_... value (store it securely)

Recommended scopes:

cli:read
cli:tokens

3) Log in

blocpad auth login --token bp_pat_...

4) Verify

blocpad auth status
blocpad context show   # shows project, task, and PM mode

5) Export task context (LLM-friendly)

blocpad task ERS-1 --md

If the task is a parent (has subtasks), export the next suggested leaf subtask:

blocpad tasks focus ERS-1 --md

6) Traditional PM projects

If your project uses Traditional PM (pm_mode='traditional'), you can also browse the full hierarchy:

blocpad pm tree --json                 # Goals > Epics > Stories > Tasks + Sprints
blocpad goals list                     # list goals
blocpad stories show <storyId> --md    # story with tasks + sprint info
blocpad sprints show <sprintId> --md   # sprint with scoped items

7) Mutate via proposals

All mutations use a safe propose-review-apply workflow:

blocpad propose task status --status done --task-number 42
blocpad apply --yes

See Proposals & Apply for the full reference. Next: use this context with your coding assistant in LLM Workflows.

Getting Started

LLMs

CLI

Architecture

Project

Quickstart

Quickstart

1) Install

2) Create a token

3) Log in

4) Verify

5) Export task context (LLM-friendly)

6) Traditional PM projects

7) Mutate via proposals

​Quickstart

​1) Install

​2) Create a token

​3) Log in

​4) Verify

​5) Export task context (LLM-friendly)

​6) Traditional PM projects

​7) Mutate via proposals

Quickstart

1) Install

2) Create a token

3) Log in

4) Verify

5) Export task context (LLM-friendly)

6) Traditional PM projects

7) Mutate via proposals