Goals, Epics & Stories

These commands require a project with pm_mode='traditional'. They return a 400 error if used on a task-management project. All commands require an active project (or --project <id>).

Goals

Goals are the top level of the PM hierarchy.

List goals

blocpad goals list
blocpad goals list --json
blocpad goals list --md

Returns all goals in the project with their epic counts.

Show a goal

blocpad goals show <goalId>
blocpad goals show <goalId> --md
blocpad goals show <goalId> --json

Returns the goal details along with:

Child epics (id, title, planned dates)
Linked pages

Epics

Epics belong to a goal and contain stories.

List epics

blocpad epics list
blocpad epics list --goal <goalId>       # filter by parent goal
blocpad epics list --json

Returns all epics with their story counts. Use --goal to filter by a specific goal.

Show an epic

blocpad epics show <epicId>
blocpad epics show <epicId> --md
blocpad epics show <epicId> --json

Returns the epic details along with:

Parent goal info
Child stories (id, title, status)
Linked pages

Stories

Stories belong to an epic and contain tasks. Stories can also be assigned to sprints.

List stories

blocpad stories list
blocpad stories list --epic <epicId>         # filter by parent epic
blocpad stories list --sprint <sprintId>     # filter by sprint membership
blocpad stories list --json

Returns all stories with their task counts. Filters can be combined.

Show a story

blocpad stories show <storyId>
blocpad stories show <storyId> --md
blocpad stories show <storyId> --json

Returns the story details along with:

Parent epic and goal breadcrumb
Child tasks (id, task_number, title, status)
Sprint membership
Story dependencies
Linked pages

PM Tree

View the full project hierarchy in a single command:

blocpad pm tree
blocpad pm tree --json
blocpad pm tree --max-depth 2    # goals + epics only (default: 4)

Displays:

Goal: Improve UX
  Epic: Redesign dashboard (2026-01-01 – 2026-03-31)
    Story: Add widgets [in_progress] (3/5 tasks)
      Task #12: Design layout [done]
      Task #13: Implement API [in_progress]
    Story: Nav redesign [backlog] (0/2 tasks)

Sprint: Sprint 5 [active] (Jan 15 – Jan 29) — 3 stories, 8 tasks

Getting Started

LLMs

CLI

Architecture

Project

Goals, Epics & Stories

Goals, Epics & Stories

Goals

List goals

Show a goal

Epics

List epics

Show an epic

Stories

List stories

Show a story

PM Tree

​Goals, Epics & Stories

​Goals

​List goals

​Show a goal

​Epics

​List epics

​Show an epic

​Stories

​List stories

​Show a story

​PM Tree

Goals, Epics & Stories

Goals

List goals

Show a goal

Epics

List epics

Show an epic

Stories

List stories

Show a story

PM Tree