The turboslide command works on a presentation folder. A presentation folder holds a deck.json file and its slides/ folder. The command looks for the folder from the current directory upward, or uses --deck <dir>. In a checkout of the repository, run it as pnpm exec turboslide.
turboslide info --jsonturboslide slides --jsonturboslide slide new --layout split --after titleturboslide render all --theme light,dark --out renders --jsonturboslide lint all --jsonturboslide export pptx --mode flatten --theme both --out exports| Flag | What it does |
|---|---|
--deck <dir> | The presentation folder. Without it, the nearest deck.json upward. |
--json | Machine output on standard output. Messages for people go to standard error. |
--author <name> | Who made the change in a local folder. Agents pass agent:<runId>. On a studio the key's owner is the author and this only labels the run. |
--base-revision <n> | For writes, the revision the change is based on. Without it, the current revision. |
| Code | Means |
|---|---|
| 0 | Success. |
| 1 | The lint gate found problems, or a verification failed. |
| 2 | A usage or validation error. |
| Group | Commands |
|---|---|
| Presentation | info, validate, deck create, deck rename, deck set, deck list, deck copy, deck trash, deck restore, deck remove --confirm |
| Files and transfer | deck pack <id>, deck unpack <file.zip>, deck push <id> --to <url>, deck pull <id> --from <url> |
| Slides | slides, slide get, slide new --layout, slide duplicate, slide skip, slide move, slide apply-layout, slide import |
| Objects | block set, block insert, block remove, block align, block group, block rotate, block crop |
| Text | text style, text list, text spacing, text replace |
| Tables and charts | table merge, table insert-rows, chart set-data, chart set-kind |
| Pictures | asset add <file or url> --alt, asset dither |
| Check | render, sheet, lint, fix, diff |
| Versions and leases | version save, version list, version restore, lease <slideId> |
| Download | export pptx, export pdf, export txt, export jpeg |
| Agents | mcp, login, logout |
turboslide <command> --help prints a command's options. The action reference lists the usage of every action.
turboslide login --to <url> connects the command line to a hosted studio. The command prints a code and the address <url>/device. Open that address while you are signed in. Check that the code matches, then click Approve. The page shows what the code asks for, such as "This code asks to read decks and edit decks". It also shows when the code was made. The command line then stores an API key for that studio, with the scopes that the code asked for. turboslide logout --to <url> revokes the key.
The key expires 90 days after it is made. After that, every command to the studio prints "Your sign in expired. Run turboslide login." and exits with code 1. To continue, run turboslide login --to <url> again.
deck push <id> --to <url> uploads a presentation folder to a studio. deck pull <id> --from <url> downloads a presentation from a studio.