publer-cli

name	publer-cli
description	Use when an agent needs to read Publer workspaces/accounts/posts/media, schedule or draft Publer posts safely, upload media, poll Publer jobs, inspect analytics, sync/search local Publer data, or call arbitrary Publer API endpoints through the publer CLI.

Publer CLI

Auth:

• Prefer PUBLER_API_KEY and PUBLER_WORKSPACE_ID.
• Profiles are supported with publer profile set --api-key-env PUBLER_API_KEY --workspace WORKSPACE_ID.
• Config precedence: flags, environment, profile/.env, defaults.

Safe workflow:

1. publer agent-context
2. publer auth status
3. publer accounts list --fields id,name,provider
4. publer --dry-run posts schedule ...
5. publer posts schedule ... --wait --timeout 90s
6. publer jobs list

Do not:

• Do not create test posts.
• Do not call posts publish-now --yes without explicit user approval.
• Do not commit .env, API keys, local SQLite databases, or release artifacts.

Use publer api request --method METHOD --path /endpoint for full API compatibility when a named command is missing.