Aidelly Docs
AI Agents

CLI Agent

Use the Aidelly CLI or Claude Code skill to post from the terminal.

Post to social media from the terminal using the @aidelly/cli npm package or the Claude Code skill.

Option 1: Aidelly CLI

Install the CLI globally:

npm install -g @aidelly/cli

Or use without installing:

npx @aidelly/cli

Authentication

aidelly auth login

Or set the environment variable:

export AIDELLY_API_KEY=aidelly_live_xxx

Post a message

aidelly post \
  --content "Hello from the CLI!" \
  --platforms linkedin,instagram \
  --publish-now

Schedule a post

aidelly post \
  --content "Scheduled announcement" \
  --platforms x,linkedin \
  --schedule-at "2026-04-18T09:00:00Z"

List recent posts

aidelly posts list --limit 10

Full command reference

aidelly --help
aidelly post --help
aidelly posts --help

See CLI Commands for the complete reference.


Option 2: Claude Code Skill

For AI-assisted social posting directly from your development workflow:

npx skills add Aidelly/aidelly-social-autopilot

After installation:

  1. Claude Code generates platform-specific content
  2. Sends a preview to your Telegram for approval
  3. Publishes to all selected platforms on approval

See Claude Setup for details.


CI/CD integration

Use the CLI in GitHub Actions or any CI pipeline:

- name: Announce release
  env:
    AIDELLY_API_KEY: ${{ secrets.AIDELLY_API_KEY }}
    AIDELLY_WORKSPACE_ID: ${{ secrets.AIDELLY_WORKSPACE_ID }}
    AIDELLY_BRAND_ID: ${{ secrets.AIDELLY_BRAND_ID }}
  run: |
    npx @aidelly/cli post \
      --content "🚀 v${{ github.ref_name }} just shipped!" \
      --platforms linkedin,x \
      --publish-now

See CI/CD Guide for more patterns.