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 |
--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 period