Skip to content

juliandickie/descript-plugin

Repository files navigation

descript

Full programmatic access to the Descript API for Claude Code. A Node/TypeScript CLI covering all 11 endpoints plus polling, the three-step signed-URL upload, and a bulk pipeline runner, wrapped by skills and an optional MCP shim.

Install (standalone)

/plugin marketplace add juliandickie/descript-plugin
/plugin install descript@descript

Setup

Create a token in Descript Settings, API tokens, then:

descript config set --token <TOKEN> --profile default
descript status

Or set DESCRIPT_API_TOKEN, or the plugin api_token config.

CLI

descript status, config, import, agent, publish, jobs, projects, published, edit-in-descript, batch

Global flags: --json, --no-wait, --token, --profile.

Skills

descript-setup, descript-import, descript-edit, descript-publish, descript-jobs, descript-batch, descript-api-reference. Edit, publish, and batch are cost-gated.

Tip - Per-cue density for chapter generation

For downstream LLM-driven content generation (YouTube descriptions, chapters, summaries), the API-derived per-cue Markdown transcript is denser and more anchor-rich than Descript's UI export. A 30-minute podcast yields ~750 timestamp anchors via this command vs ~50-100 from the UI's paragraph segmentation - useful when the downstream LLM needs many candidate chapter boundaries.

Relationship to the official Descript CLI

Descript publishes its own CLI as @descript/platform-cli (npm install -g @descript/platform-cli@latest, then descript-api config set api-key). It wraps the same API this plugin wraps, with interactive flows for setup, import, and agent prompting. This plugin is parallel, not a replacement. It adds Claude Code skills, an optional MCP shim, a bulk pipeline runner (descript batch), the export workflow (descript export, descript download-published), the partner-gated edit-in-descript, and the published-metadata reader. The two surfaces overlap on the basics (status, config, import, agent, publish, jobs, projects) and can coexist on the same machine. Use the official CLI for standalone terminal work; use this plugin for Claude-mediated work.

Development

npm install
npm test
npm run build

Zero runtime dependencies.

About

Full programmatic access to the Descript API for Claude Code: import, Underlord agent edits, publish, jobs, and bulk pipelines via a zero-dependency Node CLI wrapped by skills and an optional MCP shim.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors