cmdhub gives the apps you use every day a clear, predictable command line. This page takes you from nothing to your first real result. For the full operating model — output modes, short refs, auth, schemas, and how to compose commands — read the Agent Manual.
1. Install and connect a tool
cmdhub get gmail # install the Gmail tool
gmail auth login # connect your Google account (opens your browser)
cmdhub runs on your machine. Each tool connects to its own account, and only the ones you ask for — connecting Gmail doesn’t touch anything else.
2. Run your first command
gmail message list --inbox --limit 5
You get a readable list. Each result is tagged with a short ref like m1 or
m2, so you can point at it in the next command without copying a long ID.
3. Follow up on a result
gmail message get m1 --view full
m1 is the first message from the list above. Most tools work this way: list
or search to find things, then act on them by their short ref.
4. Do something real
Search your inbox, then open the top hit in full:
gmail message list --query "invoice" --inbox --limit 5
gmail message get m1 --view full
From here each next step is its own command — download an attachment, mark it read, or reply. Every tool follows the same find-then-act shape, so once Gmail makes sense, Calendar and the rest will too.
5. When you are ready to script
Add --jsonl to a list or search command to get one machine-readable record
per line, ready to pipe into the next command:
gmail message list --inbox --limit 5 --jsonl \
| gmail message get
Use the plain output when you are reading results yourself, and --json or
--jsonl when a script or another command needs the structured fields. There is
more on this in the Agent Manual.
6. Before you change anything
Reading is always safe. Commands that send, create, update, or delete change
real data, so they don’t just run — they preview first, or wait for an explicit
--yes.
gmail message trash --all --dry-run # show what would happen, change nothing
gmail message trash --all --yes # skip the prompt and run it for real
Only pass --yes when you mean it. The Agent Manual
covers the full safety model.
7. Pick your tools
Gmail is one of many. Browse the integrations to install the apps you use — each one has its own reference page with every command and example.