Using the CLI

The CLI wraps the API into a simple to use command line tool with interactive flows for setting up authentication, importing, and prompting the agent. It also has built-in polling for job completion.

Requirements

Before installing the CLI, you’ll need Node.js 24 or higher. Visit nodejs.org to download and install the latest LTS version for your operating system.

Install and set up

First, install the latest version of the CLI using npm.

npm install -g @descript/platform-cli@latest

Next, configure the CLI with your API key.

descript-api config set api-key

Import media

Use the import command to create a project by passing a project name and the link to any media you want to upload, or run descript-api import for interactive mode. The CLI shows live progress and outputs the project ID when done.

descript-api import \
  --name "My First Project" \
  --media "https://test-files.descriptapi.com/demo-video.mp4"

Use the agent

Use the agent command to edit a project by passing in the project id and an Underlord prompt.

descript-api agent \
  --project-id YOUR_PROJECT_ID \
  --prompt "Remove filler words and add Studio Sound to all clips"

You can also ask Underlord create a new project from a prompt alone by writing the script for you!

descript-api edit --new \
  --prompt "Write a script about how to make great coffee"

All commands

Run descript-api help to see the full list of available commands and options.

Get started

Guides

MCP

Partner integrations

API endpoints

Requirements

Install and set up

Import media

Use the agent

All commands

​Requirements

​Install and set up

​Import media

​Use the agent

​All commands

Requirements

Install and set up

Import media

Use the agent

All commands