# Docs

You mostly talk to your agent and it runs these for you. This page is the reference for when you want to know what is happening, or do a step yourself.

## Install and sign in

Paste that into Claude Code, Codex or a terminal. Your browser opens; sign in with Google and press Authorize. The first time, you paste your licence key on that page once and the account remembers it. On a Mac the key is then stored in your keychain. The pack is installed for every agent found: Claude Code, Codex, Cursor, OpenCode, Antigravity and Kimi.

On a machine with no browser, pass the key instead: `setup --key -` reads it from standard input.

## Commands

| Command | What it does |
| --- | --- |
| `setup` | Install or update the pack and sign this computer in |
| `doctor` | Check Node.js, FFmpeg, Chrome, HyperFrames and your subscription |
| `voices` / `credits` | List voices and the voiceover credits left this month |
| `voice <project> --script <file> --voice <id>` | Generate narration for every scene or slide. `--tone "warm teacher"` directs an expressive voice |
| `music <project> --bed calm/focus/bright/lofi` | Add one of the bundled music beds |
| `share <project> [--deck] [--password …] [--public]` | Upload the video or deck and get a link |
| `shares` / `unshare <id>` | List or remove links; Studio also shows views and exercise answers |
| `logout` | Sign this computer out and free its seat |

Each is run as `npx -y motionkit-skills@latest <command>`.

## Tools your agent runs

| Tool | What it does |
| --- | --- |
| `ingest` | Reads Word, PowerPoint, PDF, Markdown, text, a web page link or a shared Google Doc into chapters, points, numbers and tables, each with its line in the source |
| `panel` | The local four-step page: pick a style, watch the build, review and edit on a timeline, play and share |
| `start` | Starts a project in one style and downloads that style |
| `images` | Draws the pictures the scenes ask for, in the look of the style |
| `music` | Makes an instrumental track from a description, as long as the video |
| `compose` | Builds the video from `video.json`: timing, motion, narration and music |
| `check` | Compares every number on screen with the source; checks timing and exercise answers |
| `frames` | Saves one picture per scene for review |
| `render` | Renders the MP4 on your computer with HyperFrames |
| `build-deck` | Builds the narrated, interactive deck from `deck.json` |
| `deck-to-pptx` | Exports the deck as a PowerPoint file |

Every tool checks your subscription with our server before it runs, so they need a connection.

## Scenes

A video is a list of scenes in `video.json`; a deck is a list in `deck.json`. Both share these: `title`, `section`, `stat`, `chart` (bar or line), `steps`, `cards`, `compare`, `figure`, `quote`, `takeaway`. A deck adds `tabs`, `expand`, `quiz`, `match`, `sort`, `group`, hover tips and five more chart kinds: pie, funnel, radar, scatter and a world map shaded by country.

Put stars around the words that carry the point, give a scene an `image` to have a picture drawn for it or a `picture` to show a file of your own, and a `narration` to have it spoken.

## Your own look

A style decides layout and motion. Add a `design` to the project file to make the colours and type yours:

```
"style": "ledger",
"design": { "bg": "#0b1f3a", "ink": "#ffffff", "accent": "#ffb703", "type": "newsprint" }
```

`bg`, `ink` and `accent` are your background, text and accent colours. `"palette": "forest-night"` uses one of the 36 ready palettes instead. `type` borrows the fonts of another style and `radius` sets the corners. The tools refuse a design whose text is hard to read and say which colour to change. Pictures are drawn in your colours.

## Music and voices

`music` makes an instrumental track from a description such as "slow warm piano, hopeful", as long as the video. The four bundled beds do not count against anything. Voices come in two kinds: 14 voices tuned to nine languages, and 11 expressive voices that read any language and follow a direction given with `--tone`.

## Limits per plan

|  | Creator | Studio |
| --- | --- | --- |
| Computers | 2 | 10 |
| Voiceover credits a month | 80,000 | 240,000 |
| Pictures a month | 60 | 200 |
| Music tracks a month | 10 | 40 |
| Share links | 10 | 100, with statistics |

## When something fails

- **A tool says the subscription is not active.** Renew on the [pricing page](https://motionforclaude.com/pricing), then run setup again.
- **Render fails.** Run `doctor`. It names what is missing and how to install it.
- **A number is rejected.** It is not in your source, or is written differently there. Fix the source or the scene, never the check.
- **Behind a proxy.** Set `HTTPS_PROXY`; the tools pick it up.

Anything else: [support@motionforclaude.com](mailto:support@motionforclaude.com).

## Make your first motion video tonight

One command, then hand your agent a document.

---
Source: https://motionforclaude.com/docs
Updated: 2026-10-12