CLI

CLI

JSON-first cutedyno CLI for agents and shell scripts.

Every data command prints JSON to stdout. Errors print JSON to stderr and exit 1.

Install

npm install -g cutedyno
# or
npx -y cutedyno auth:status

Auth

export CUTEDYNO_API_KEY=cdyn_live_...
cutedyno auth:status
cutedyno auth:set --key cdyn_live_...

Key resolution order: --keyCUTEDYNO_API_KEY~/.cutedyno/credentials.json.

Workflow

cutedyno profiles:list
cutedyno accounts:list --profile "$PROFILE"
cutedyno policy:get --profile "$PROFILE"
cutedyno media:upload ./clip.mp4 --profile "$PROFILE"
cutedyno analytics:get --profile "$PROFILE"
cutedyno analytics:history --from 2026-01-01 --to 2026-01-31 --profile "$PROFILE"
cutedyno posts:create --json ./post.json
cutedyno posts:publish --id "$POST_ID"

Browser upload for agents

When you cannot read files from the user's machine:

SESSION=$(cutedyno media:upload-session --profile "$PROFILE")
echo "$SESSION" | jq -r '.uploadUrl'   # user opens this in a browser
cutedyno media:upload-session:get --id "$(echo "$SESSION" | jq -r '.id')" --profile "$PROFILE"

Quick text post:

cutedyno posts:create -c "Hello" -a acct_1 --profile "$PROFILE" --now

Flags

FlagPurpose
--json <file>Body matching OpenAPI (- = stdin)
--profile / -pProfile id
-cContent
-aComma-separated account ids
-sISO 8601 scheduledAt
--nowpublishNow: true
--api-urlOverride API base URL

MCP

cutedyno mcp

Cloud agents: hosted MCP at https://api.cutedyno.com/mcp.

Skills

npx skills add cutedyno/cutedyno-agent

More: agent landing.