Aidelly Docs
CLI

Commands

Full command reference for the Aidelly CLI.

Global flags

FlagDescription
--api-key <key>Override AIDELLY_API_KEY
--workspace-id <id>Override AIDELLY_WORKSPACE_ID
--brand-id <id>Override AIDELLY_BRAND_ID
--jsonOutput raw JSON
--helpShow help for a command
--versionShow CLI version

aidelly auth

aidelly auth login      # Authenticate interactively
aidelly auth logout     # Remove stored credentials
aidelly auth whoami     # Show current authenticated user

aidelly post

Create a post.

aidelly post [options]
OptionDescription
--content <text>Post text content (required)
--platforms <list>Comma-separated platforms: instagram,tiktok,youtube,x,linkedin,facebook,bluesky,threads,pinterest,google_business
--publish-nowPublish 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-now

aidelly 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 post

List options:

OptionDescription
--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 abc123

aidelly analytics

aidelly analytics get <post-id>    # Get analytics for a post
aidelly analytics summary          # Aggregate analytics for the period

aidelly connections

aidelly connections list    # List connected social accounts

aidelly usage

aidelly usage    # Show API usage for the current billing period

Coming 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 @handle

Until 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.