Introduction

BlocPad CLI lets you read and mutate project context from BlocPad in formats that work well for both humans and tooling:

JSON for scripts and integrations
Markdown for LLM prompts and agent workflows

The CLI supports both Task Management and Traditional PM project modes:

Task Management (pm_mode=’tasks’): flat task hierarchy with parent/child nesting, comments, checklists, and pages.
Traditional PM (pm_mode=’traditional’): Goals → Epics → Stories → Tasks → SubTasks, plus Sprints with scope management.

What you can do

Read: fetch projects, tasks, pages, goals, epics, stories, sprints, and their relationships.
Mutate: propose changes (create, update, delete, status transitions) through a safe propose-review-apply workflow.
Export: generate rich context exports for AI coding tools (Cursor, Codex, Claude, Gemini).

Outputs at a glance

--json: structured output to stdout; interactive prompts (if any) go to stderr.
--md: plain text Markdown suitable for copy/paste into AI tools.

If you’re using Cursor or an LLM CLI, start with LLM Workflows.