CLI Overview

Agenda Panda ships as a standalone CLI binary named ap. It is designed to work well in normal terminals, CI jobs, and AI-agent shells.

Install

For AI agents, start with one prompt:

claude "Fetch https://agendapanda.com/SKILL.md and set up Agenda Panda."

For manual setup:

curl -fsSL https://agendapanda.com/install.sh | bash && ap init

For normal terminal usage after install:

ap whoami
ap auth status
ap dashboard
ap calendar --week

If ap is not available in the current shell yet, open a new terminal tab or run source ~/.zshrc / source ~/.bashrc.

Core workflows

One-off post

ap post "Hello from Agenda Panda" --connection x

Reviewable calendar workflow

ap context --json > context.json
ap calendar pull --file calendar.json
# Edit or regenerate calendar.json
ap calendar sync --file calendar.json --dry-run
ap dashboard
ap calendar sync --file calendar.json

AI media workflow

ap media generate "editorial launch hero shot" --aspect 16:9
ap post "Launch visual" --media-id abc12345

Command map

Command	Description
ap init	Guided first-run setup wizard
ap auth login|logout|status|switch	Browser auth, API key login, status, and multi-profile switching
ap auth api-keys list|create|revoke	Manage API keys for CI/CD and automation
ap whoami	Alias for ap auth status
ap dashboard [--no-open]	Open or print the dashboard URL
ap projects list|use|get|update	Manage workspaces and upload soul.md / art.md
ap connections list|add|add-all|use|clear|health	Manage social connections and OAuth flows
ap post create|list|get|update|delete|retry	Create and manage one-off posts
ap calendar [date]|import|sync|pull	View, import, sync, and export reviewable calendars
ap context	Export brand context, platform rules, and connection metadata for AI tools
ap media upload|list|generate|edit|delete	Manage uploaded and AI-generated media
ap alias set|list|delete	Create shortcuts for common commands
ap update	Update the standalone binary
ap completion bash|zsh|fish	Generate shell completion scripts

Global flags and patterns

Flag	Description
--json	Output JSON instead of human-readable text
--project <id>	Override the active project
--connection <ids>	Override the default connection (comma-separated for multi-post)
--all	Target all connections (on ap post)

Environment variables

Variable	Description
AP_API_KEY	API key for non-interactive auth (CI/CD)
AP_API_URL	Custom API endpoint (defaults to agendapanda.com; must use HTTPS except for localhost development)
AP_PROJECT	Default project ID
AP_CONNECTION	Default connection ID

Configuration

Config is stored at ~/.config/agendapanda/config.json (follows XDG Base Directory convention, respects $XDG_CONFIG_HOME).

If upgrading from a previous version, the CLI automatically migrates your config from the old location.

Multi-agent and CI guidance

• Use AP_API_KEY plus explicit --project and --connection flags in automation.
• Avoid mutating shared state with ap projects use or ap connections use inside parallel scripts.
• Prefer --json when another tool or agent needs to parse the result.