CLI
Commands
Full command reference for the Aidelly CLI.
Global flags
| Flag | Description |
|---|---|
--api-key <key> | Override AIDELLY_API_KEY |
--workspace-id <id> | Override AIDELLY_WORKSPACE_ID |
--brand-id <id> | Override AIDELLY_BRAND_ID |
--json | Output raw JSON |
--help | Show help for a command |
--version | Show CLI version |
aidelly auth
aidelly auth login # Authenticate interactively
aidelly auth logout # Remove stored credentials
aidelly auth whoami # Show current authenticated useraidelly post
Create a post.
aidelly post [options]| Option | Description |
|---|---|
--content <text> | Post text content (required) |
--platforms <list> | Comma-separated platforms: instagram,tiktok,youtube,x,linkedin,facebook,bluesky,threads,pinterest,google_business |
--publish-now | Publish immediately |
--schedule-at <iso> | Schedule for an ISO 8601 datetime |
--media <path> | Attach a local image or video file |
--brand-id <id> | Override default brand |
Examples:
# Publish immediately to two platforms
aidelly post \
--content "Big news — we just launched!" \
--platforms linkedin,x \
--publish-now
# Schedule for later
aidelly post \
--content "See you at the conference." \
--platforms instagram,linkedin \
--schedule-at "2026-04-25T10:00:00Z"
# Post with an image
aidelly post \
--content "Check out our new product." \
--platforms instagram \
--media ./product.jpg \
--publish-nowaidelly posts
Manage existing posts.
aidelly posts list [options] # List posts
aidelly posts get <id> # Fetch a single post
aidelly posts cancel <id> # Cancel a scheduled postList options:
| Option | Description |
|---|---|
--status <status> | Filter by: draft, scheduled, published, failed, canceled |
--platform <name> | Filter by platform |
--limit <n> | Number of results (default: 20) |
--after <iso> | Show posts after this datetime |
--before <iso> | Show posts before this datetime |
Examples:
# List scheduled posts
aidelly posts list --status scheduled
# Get a specific post
aidelly posts get abc123
# Cancel a scheduled post
aidelly posts cancel abc123aidelly analytics
aidelly analytics get <post-id> # Get analytics for a post
aidelly analytics summary # Aggregate analytics for the periodaidelly connections
aidelly connections list # List connected social accountsaidelly usage
aidelly usage # Show API usage for the current billing periodComing next release (May 2026 dashboard features)
The CLI mirrors the public v1 API. The following commands are reserved for the next release, when the matching internal routes are promoted to v1:
# Crosspost routes — publish fans out to up to 12 destinations
aidelly routes list
aidelly routes create --source-account <id> --destinations <ids>
aidelly routes dry-run <route-id> --sample-post-id <id>
# Automation queues — Buffer-style weekly slot grids with drip + recycle
aidelly queues list
aidelly queues create --name <name> --timezone <tz> --slots <grid>
aidelly queues add <queue-id> --post-id <id>
# Post signatures — auto-appended workspace CTAs
aidelly signatures list
aidelly signatures set --platform <platform> --text <signature>
# Content campaigns — themed routing groups
aidelly campaigns list
aidelly campaigns create --name <name> --channels <list>
aidelly campaigns assign <campaign-id> --post-id <id>
# Auto-Post sources — RSS / podcast / newsletter / YouTube
aidelly auto-post sources list
aidelly auto-post sources connect --type rss --url <url>
aidelly auto-post sources connect --type youtube --channel @handleUntil promoted, these features are managed via the dashboard at
/automation/routes, /automation (Queues tab), /settings/social-accounts
(Post Signatures), /content (Campaigns chip rail), and
/automation/auto-post.