Troubleshooting

Auth fails / 401 Unauthorized

Confirm your token is valid and has the right scopes (commonly cli:read and cli:tokens).
Re-run login with an explicit token:

blocpad auth login --token bp_pat_...

Confirm you can reach https://www.blocpad.com from your network and that you’re authenticated.

Set a project once:

blocpad context set-project prj_123

Or override per command:

blocpad --project prj_123 tasks list --json

The CLI stores config in your per-user config directory (see Configuration). To isolate a clean config for testing:

export BLOCPAD_CONFIG_DIR=/tmp/blocpad-config
blocpad auth login --token bp_pat_...