docs: add CLI content command documentation (#61)

* docs: add CLI content command documentation

Documents the new recoup content command suite: templates, validate,
estimate, create, and status subcommands with flags and examples.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: move run status to recoup tasks, remove from content

Run status is a general tasks concept, not content-specific.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: rename SDK page to CLI, add content commands after tasks section

- Rename sdk.mdx → cli.mdx with /cli route
- Update docs.json navigation reference
- Re-add content section (templates, validate, estimate, create) after tasks

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: add API reference links to content CLI commands

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: use artist_account_id instead of artistSlug in content CLI docs

Aligns CLI docs with the API reference which uses artist_account_id.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: link 'recoup tasks status' to tasks section in create content docs

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: sweetmantech

sdk.mdx cli.mdxsdk.mdx renamed to cli.mdx

@@ -107,3 +107,76 @@ recoup sandboxes create
 recoup sandboxes create --command "ls -la"
 recoup sandboxes list --json
 ```
+
+## tasks
+
+Check the status of background task runs. See [`GET /api/tasks/runs`](/api-reference/tasks/runs).
+
+```bash
+recoup tasks status --run <runId>
+recoup tasks status --run <runId> --json
+```
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `--run <id>` | Yes | Trigger.dev run ID |
+
+## content
+
+Content-creation pipeline commands. Generate AI-powered social videos for artists.
+
+### List templates
+
+List available content templates. See [`GET /api/content/templates`](/api-reference/content/templates).
+
+```bash
+recoup content templates
+recoup content templates --json
+```
+
+### Validate artist
+
+Check that an artist has the required assets (face-guide, songs, context files) before creating content. See [`POST /api/content/validate`](/api-reference/content/validate).
+
+```bash
+recoup content validate --artist <artistAccountId>
+recoup content validate --artist <artistAccountId> --json
+```
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `--artist <id>` | Yes | Artist account ID |
+
+### Estimate cost
+
+Preview the estimated cost and duration for a content run without starting it. See [`POST /api/content/estimate`](/api-reference/content/estimate).
+
+```bash
+recoup content estimate --artist <artistAccountId>
+recoup content estimate --artist <artistAccountId> --template <name> --json
+```
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `--artist <id>` | Yes | Artist account ID |
+| `--template <name>` | No | Template name (default: random) |
+| `--lipsync` | No | Enable lipsync mode |
+| `--upscale` | No | Enable upscaling |
+
+### Create content
+
+Trigger the full content-creation pipeline. Returns a run ID you can check with [`recoup tasks status`](/cli#tasks). See [`POST /api/content`](/api-reference/content/create).
+
+```bash
+recoup content create --artist <artistAccountId>
+recoup content create --artist <artistAccountId> --template <name> --lipsync --upscale
+recoup content create --artist <artistAccountId> --json
+```
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `--artist <id>` | Yes | Artist account ID |
+| `--template <name>` | No | Template name (default: random) |
+| `--lipsync` | No | Enable lipsync mode |
+| `--upscale` | No | Enable upscaling |
+| `--caption-length <n>` | No | Max caption length in characters |

docs.json

@@ -19,7 +19,7 @@
               "index",
               "quickstart",
               "mcp",
-              "sdk",
+              "cli",
               "api-reference/sandboxes/create"
             ]
           }