CLI tool reference

Reference for the command-line tools the DevThrottle installer puts on your PATH. They exist so your agents (and you) have a reliable, pre-installed way to produce documents, send email, work with images, keep a personal knowledge vault, and drive the DevThrottle fleet itself. Eight tools ship; nothing else is listed here. Every tool answers --help with its full command list.

Document conversion: cc-pdf, cc-html, cc-word

Three converters that turn a Markdown file into a finished document - and read a finished document back to Markdown. They share the same two commands, the same option style, and the same theme set, so learning one is learning all three.

cc-pdf from-markdown input.md -o output.pdf --theme boardroom
cc-html from-markdown input.md -o output.html --theme paper
cc-word from-markdown input.md -o output.docx --theme boardroom
cc-pdf from-markdown input.md -o output.pdf --page-size a4 --margin 1in
cc-pdf to-markdown report.pdf -o report.md

• from-markdown - Markdown in, finished document out. to-markdown - the other direction, extracting the document's embedded images as it goes.
• -o - output file path. Required on from-markdown; on to-markdown it defaults to the input name with a .md extension.
• --theme - document style, paper by default (see themes below).
• --page-size - a4 (the default) or letter (cc-pdf only).
• --margin - page margin, e.g. 1in (cc-pdf only).
• --force overwrites an existing output file, --no-clobber skips instead, and --quiet suppresses progress without hiding errors.

The shared themes, from cc-pdf --themes:

• boardroom - corporate, executive style with serif fonts; the pick for professional reports.
• paper - minimal and clean (the default).
• terminal - technical, monospace.
• blueprint - technical documentation.
• thesis - academic.
• spark - creative, colorful.
• obsidian - dark theme.

cc-devthrottle

The fleet command surface: talk to your running sessions, the machines they run on, and the Gateway that holds them together - the same tool your agents use to message each other. The fleet commands call the Gateway with the calling session's own key; every session launched by a Director attached to a Gateway carries that credential in its environment (CC_GATEWAY_URL and CC_GATEWAY_SESSION_KEY) - so run them from inside such a session, or export that pair in a plain terminal first. A local-only Director stamps neither, and the commands say so. Local commands such as setup status and actions work anywhere.

cc-devthrottle session list
cc-devthrottle message send <id> "message"
cc-devthrottle session workers
cc-devthrottle schedule list
cc-devthrottle setup status

Eighteen command groups, each with its own --help:

• session - the sessions themselves: list, whoami, rename, prompt, interrupt, raise, workers, hold, compact, compact-continue, buffer, role, done, spawn.
• message - send a message to another session, or ask and wait for its answer (see fleet messaging).
• mission - the unit of work sessions attach to: create, list, rename, complete, remove, reopen, attach, detach.
• director - list every Director this account is running, with the id to pass to session spawn --director.
• machine - the computers you can reach: list, apps, files, launch (see machines).
• repo - list the fleet's repositories with their state and worktree summary.
• worktree - list the fleet's worktrees, their sizes, and which session is in each.
• workflow - read and author fleet workflows: list, show, instructions, versions, pull, push, publish, materialize, runs, run, enable, disable, clone, delete.
• skill - the same shape for fleet skills: list, get, show, versions, pull, push, publish, clone, enable, disable, delete.
• schedule - list, get, create, run, enable, disable, delete, plus runs and endpoint (see scheduled runs).
• browser - DevThrottle's drivable browser profiles, signed in once by hand and then driven by an agent: list, create, signin, start, stop, attach, rename, remove. Machine-local.
• diag - network (per connected device: direct or relayed, latency, UDP and NAT) and results (recent speed tests submitted from the app or the Cockpit); see network.
• autostart - on, off, status for starting the Gateway at login.
• email - owner sends one email to the account owner, and there is no way to address anyone else.
• settings - read and write Director settings: show, get, set, list, path.
• setup - status, install, update, repair, doctor.
• selftest - run the fleet-messaging self-test against the local Director.
• actions - list the agent-discoverable actions.

Two of the session commands are how a session asks for help when nobody is watching it. session raise puts a session's hand up to whichever session is driving it - a worker to its manager, say - with a line saying what it is blocked on; the hand comes down when that session's turn ends, or on --clear. session workers is the other end of the same channel: it lists the sessions you are driving and which of them have their hand up. They exist because a supervised session is quiet toward you by design, and it still needs somewhere to put a question it cannot answer itself.

workflow and skill are the command-line windows onto two Gateway-held libraries, and each has its own page: workflows for how a whole job is run and who staffs it, skills for the individual capabilities an agent picks up in the middle of one. Both follow the same rule - push uploads a private draft that no agent sees, and publish is what makes it live fleet-wide.

Email: cc-gmail and cc-outlook

Read, search, send, and manage email from the command line - one tool per provider, with matching command styles. Both authenticate once (auth) and then work non-interactively, which is what makes them usable by agents.

cc-gmail list
cc-gmail search "from:someone@example.com"
cc-gmail send --to someone@example.com --subject "Hi" --body "..."
cc-outlook list
cc-outlook reply <id> --body "..."

• Shared commands: auth, list, read, send, draft, reply, search, archive, move, recipients, profile.
• cc-gmail adds count, labels, delete/untrash, and a mailbox stats dashboard; searches use Gmail query syntax.
• cc-outlook adds forward, flag, categorize, attachments, download-attachment, and folders/create-folder; auth is Device Code Flow.
• Both go beyond the inbox: calendar on each, and contacts on cc-gmail.
• Both take --account to pick between signed-in accounts, and accounts to manage them.

cc-image

Image toolkit: AI description and text extraction plus local resize and format conversion. The AI commands run through the DevThrottle API with your dt_ key; the local commands need no key at all.

cc-image describe photo.png
cc-image ocr scan.png
cc-image resize big.png -o small.png --width 800
cc-image convert image.png -o image.webp

• describe / ocr - AI analysis and text extraction, single image or whole folders (batch cataloging to JSON/CSV with resume). Requires DEVTHROTTLE_API_KEY.
• resize / convert / info - local, keyless image operations.
• Images are downscaled before AI analysis, so bulk runs stay cheap.

cc-vault

A personal knowledge vault - contacts, tasks, goals, ideas, health notes, posts, and documents - with semantic search and ask-a-question retrieval over everything in it. Your vault's data is stored on this machine. Search and ask are the exception: both send what they retrieve to an outside model service, so both need a key you supply and pay for, set as OPENAI_API_KEY. cc-vault config show prints whether it is set, and without it those two commands stop rather than quietly returning something weaker.

cc-vault init
cc-vault search "kickoff meeting notes" --hybrid
cc-vault ask "what did we decide about pricing?"
cc-vault tasks add "Follow up with the pilot customer"
cc-vault backup

• Entities: contacts, tasks, goals, ideas, docs, health, posts - each its own group, with add/list/update commands under it.
• Organising them: lists and tags for contacts, library and catalog for documents, graph for statistics and traversal.
• Retrieval: search (semantic, with --hybrid to add keyword matching and --type to narrow it) and ask (question answering over the vault).
• Connecting things: link, unlink, links, and context, which returns an entity together with everything linked to it - the shape an agent wants.
• Care and feeding: stats, config show, backup, restore, and repair-vectors to rebuild the search index from the stored text.