`content` — Content CLI

A thin command-line client for the Content engine, built on the official Python SDK (content_sdk) — it never speaks HTTP itself and never runs the planner, yt-dlp or ffmpeg. Ergonomic shortcuts (video, audio) are normalized to canonical GenerationRequests; there is no parallel contract.

Install

The CLI is an ordinary Python application — nothing to clone:

uv tool install content-cli     # isolated, on your PATH — recommended
content --help

# or
pipx install content-cli

content-cli on PyPI pulls content-sdk as an ordinary dependency, pinned to the matching release. The wheels are also attached to each GitHub release for air-gapped installs (uv tool install ./content_cli-<v>-py3-none-any.whl --find-links .).

From a clone

pip install ./packages/python-sdk ./apps/cli     # exposes `content`

For development

make install    # editable installs of the engine, SDK, CLI and MCP in one venv

Build the distributions yourself with make wheels (they land in dist/).

Point it at your engine

--api-url URL or CONTENT_API_URL (default http://localhost:8010):

export CONTENT_API_URL=http://nas.local:8010
content health

Commands

content health
content config
content analyze https://youtu.be/… [--credential youtube]
content analysis <analysis_id>           # re-fetch a stored analysis (ADR 0014)
content video  https://youtu.be/… --height 1080 --container mkv --subs en,fr --watch
content audio  https://youtu.be/… --format opus --folder music --name track --watch
content video  https://…/playlist?list=… --playlist --watch      # each item
content submit request.json --watch      # raw GenerationRequest (or - for stdin)
content jobs
content job    <job_id>
content watch  <job_id>
content artifacts <job_id>
content download <artifact_id> -o out.mkv
content cancel <job_id> ; content retry <job_id>

Global flags: --api-url URL and --json (raw JSON output) go before the subcommand. Exit code is non-zero on API errors or a failed watched job.

Exit codes when watching a job

content ... --watch and content watch <job> return the outcome, so a script can chain on it (ADR 0021):

Code	Meaning
`0`	`succeeded` — everything asked for was produced
`2`	`partially_succeeded` — some of it was, and at least one step failed
`1`	`failed` or `cancelled`

2 is deliberately distinct from 1. A playlist that yielded five videos of six, or a download whose delivery into your library was refused, is not a failure — but it is not a success either, and a script that treats it as one will quietly move on with missing files.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

content_cli-0.6.7.tar.gz (21.0 kB view details)

Uploaded Aug 23, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

content_cli-0.6.7-py3-none-any.whl (22.9 kB view details)

Uploaded Aug 23, 2026 Python 3

File details

Details for the file content_cli-0.6.7.tar.gz.

File metadata

Download URL: content_cli-0.6.7.tar.gz
Upload date: Aug 23, 2026
Size: 21.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for content_cli-0.6.7.tar.gz
Algorithm	Hash digest
SHA256	`9cb06770326acaa61ada2f1dba11fb955c346649f541932b760333b19f4b29d6`
MD5	`57b347674356e7547c44689068803e59`
BLAKE2b-256	`1ff01ace44b37f04900638ae032137a958daa43d3044b6b2d134bd795828f67f`

See more details on using hashes here.

Provenance

The following attestation bundles were made for content_cli-0.6.7.tar.gz:

Publisher: publish-pypi.yml on LatentNoise/content

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: content_cli-0.6.7.tar.gz
- Subject digest: 9cb06770326acaa61ada2f1dba11fb955c346649f541932b760333b19f4b29d6
- Sigstore transparency entry: 2568685777
- Sigstore integration time: Aug 23, 2026
Source repository:
- Permalink: LatentNoise/content@2ed65d79119b9b14d8471241909d2f3a0ed41f8d
- Branch / Tag: refs/tags/v0.6.7
- Owner: https://github.com/LatentNoise
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-pypi.yml@2ed65d79119b9b14d8471241909d2f3a0ed41f8d
- Trigger Event: release