Skip to Content
TurboslideDocumentation
The command line in AgentsContents

The command line

Run every action from a terminal with the turboslide command, read its JSON output and exit codes, and move presentations to and from a studio.

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.

Shell
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

Flags every command takes

FlagWhat it does
--deck <dir>The presentation folder. Without it, the nearest deck.json upward.
--jsonMachine 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.

Exit codes

CodeMeans
0Success.
1The lint gate found problems, or a verification failed.
2A usage or validation error.

Command groups

GroupCommands
Presentationinfo, validate, deck create, deck rename, deck set, deck list, deck copy, deck trash, deck restore, deck remove --confirm
Files and transferdeck pack <id>, deck unpack <file.zip>, deck push <id> --to <url>, deck pull <id> --from <url>
Slidesslides, slide get, slide new --layout, slide duplicate, slide skip, slide move, slide apply-layout, slide import
Objectsblock set, block insert, block remove, block align, block group, block rotate, block crop
Texttext style, text list, text spacing, text replace
Tables and chartstable merge, table insert-rows, chart set-data, chart set-kind
Picturesasset add <file or url> --alt, asset dither
Checkrender, sheet, lint, fix, diff
Versions and leasesversion save, version list, version restore, lease <slideId>
Downloadexport pptx, export pdf, export txt, export jpeg
Agentsmcp, login, logout

turboslide <command> --help prints a command's options. The action reference lists the usage of every action.

Connect to a studio

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.