Blocpad CLI-The missing layer for cursor

Blocpad CLI is a command-line tool designed to connect your BlocPad projects with automation and Large Language Model (LLM) workflows. It acts as a bridge, allowing you to export information from BlocPad in formats that computers and AI can easily understand.

Benefits

Blocpad CLI helps you use your BlocPad projects as a central source of information. It lets you export exactly what you need for other tools or AI without losing important details or compromising security. The tool offers clear scope control, meaning you work within a specific project or task. Its JSON output is stable and great for scripts and integrations, while its Markdown export is perfect for copying into AI tools. It is designed to be safe by default, with read-only exports and secure handling of sensitive information. It also supports agent workflows, helping focus on the next small task, and allows you to easily change local settings using commands or environment variables.

Use Cases

Blocpad CLI is useful for automating tasks and enhancing AI workflows. You can use it to export project, task, or page context from BlocPad. For example, you can set up your coding tools like Cursor, Codex CLI, Claude CLI, or GitHub Copilot to work with BlocPad tasks. The CLI can list tasks, show task details in Markdown, provide a tree view of tasks, select the next task to work on, or export the full context for a specific task. This allows AI assistants to understand the context of your work and help you complete tasks more efficiently.

Vibes

Blocpad CLI is designed for safe, read-only exports to be used with automation and LLM workflows. To use it, you first need to install it and then set up rules for your coding tool. You authenticate by creating a Personal Access Token in BlocPad settings and logging in via the CLI. When using the JSON flag, prompts are sent to stderr, keeping the standard output machine-readable. Configuration files are stored locally, and this location can be changed if needed. For coding assistants, you can export Markdown context and paste it into your assistant's prompt.

Additional Information

Blocpad CLI can be installed globally using npm with the commandnpm i -g blocpad-cli. To authenticate, you create a Personal Access Token in BlocPad Settings and runblocpad auth login --token bp_pat_.... The CLI stores configuration in your user config directory, for example,~/Library/Application Support/blocpad/on macOS, but this can be changed using theBLOCPAD_CONFIG_DIRenvironment variable.