<!-- https://cutedyno.com/docs/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

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

## Auth

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

Key resolution order: `--key` → `CUTEDYNO_API_KEY` → `~/.cutedyno/credentials.json`.

## Workflow

```bash
cutedyno profiles:list
cutedyno accounts:list --profile "$PROFILE"
cutedyno policy:get --profile "$PROFILE"
cutedyno media:upload ./clip.mp4 --profile "$PROFILE"
cutedyno posts:create --json ./post.json
cutedyno posts:publish --id "$POST_ID"
```

Quick text post:

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

## Flags

| Flag | Purpose |
| --- | --- |
| `--json <file>` | Body matching OpenAPI (`-` = stdin) |
| `--profile` / `-p` | Profile id |
| `-c` | Content |
| `-a` | Comma-separated account ids |
| `-s` | ISO 8601 `scheduledAt` |
| `--now` | `publishNow: true` |
| `--api-url` | Override API base URL |

## MCP

```bash
cutedyno mcp
```

Cloud agents: [hosted MCP](/docs/mcp) at `https://api.cutedyno.com/mcp`.

## Skills

```bash
npx skills add cutedyno/cutedyno-agent
```

More: [agent landing](/agent).