How do I install the CLI?
Run npm install -g @aidelly/cli for a global install, or use npx @aidelly/cli to run without installing.
Install @aidelly/cli and get 15 command groups for posting, scheduling, batch operations, analytics, inbox management, and more. Pipe JSON output to other tools. Use in scripts and CI/CD pipelines.
From zero to your first post in under a minute.
Install the CLI
Install globally or run with npx:
npm install -g @aidelly/cli
# Or run without installing:
npx @aidelly/cliAuthenticate
Log in with your Aidelly account. Your API key is stored locally.
aidelly auth loginFor CI/CD: set AIDELLY_API_KEY or use aidelly config set api-key YOUR_KEY.
Create your first post
aidelly post create \
--platform instagram \
--text "Hello from the CLI!"✓ Post created
{ "id": "post_x7k2", "status": "published" }
15 command groups covering every social media operation. Run aidelly <command> --help for details.
authLogin, logout, status, switch profilespostCreate, list, get, update, cancel, schedule postsmediaUpload images and videos for use in postsconnectionsList connected platforms and accountsbatchBulk operations from CSV or JSON filesanalyticsFetch views, likes, comments, and sharesapprovalsManage content approval workflowsinboxRead and reply to comments and DMsautomationsCreate and manage content automationscalendarView and manage content calendarbrandManage brand profiles and settingswebhooksCreate and manage webhook subscriptionsusageCheck API usage and rate limitsconfigGet, set, and list CLI configurationmcpRun Aidelly as an MCP server for AI agentsSwitch between accounts and workspaces with --profile. Store multiple API keys locally.
Publish weeks of content from a CSV or JSON file. Supports --dry-run and --parallel flags.
Pass --json to any command for machine-readable output. Pipe to jq, scripts, or dashboards.
Schedule posts with ISO 8601 timestamps. View and manage your content calendar from the terminal.
Upload a CSV with posts, platforms, and times, then run aidelly batch run posts.csv to publish everything at once.
Add a post step to your deployment pipeline that announces new releases across all platforms automatically.
Use --profile to switch between client accounts without re-authenticating. Perfect for agencies.
Pipe aidelly analytics --json into jq or a dashboard tool for automated reporting.
# Schedule a post for tomorrow at 9am
aidelly post schedule \
--platform linkedin \
--text "We just shipped v2.0!" \
--at "2026-03-27T09:00:00Z"
# Batch publish from a CSV file
aidelly batch run content.csv --parallel 3
# Check analytics as JSON
aidelly analytics summary --json | jq '.views'
# Upload media and attach to a post
aidelly media upload ./product-shot.jpg
aidelly post create \
--platform instagram \
--text "New product launch!" \
--media media_abc123
# Switch profiles for multi-brand management
aidelly auth switch client-acme
aidelly post list --jsonThese flags work with any command:
| Flag | Description |
|---|---|
| --json | Output as machine-readable JSON |
| --profile <name> | Use a named auth profile |
| --workspace <id> | Override workspace ID |
| --brand <id> | Override brand ID |
| --verbose | Show debug output |
| --quiet | Suppress non-essential output |
| --no-color | Disable colored output |
Run npm install -g @aidelly/cli for a global install, or use npx @aidelly/cli to run without installing.
Yes. API access requires an active paid plan (Launch, Growth, or Scale). Generate your API key from Settings → API Keys in the dashboard.
Yes. Set the AIDELLY_API_KEY environment variable or use aidelly config set api-key YOUR_KEY to configure non-interactively.
Human-readable tables by default. Pass --json to any command for machine-readable JSON output that pipes to jq or other tools.
Yes. Use aidelly auth switch to change profiles, or pass --profile <name> to any command.
Instagram, TikTok, YouTube, X (Twitter), LinkedIn, Facebook, and Bluesky. All from a single command.