[CLI]
run tokenhq, your home for hiring an LLM
[ install ]
npm i -g @tokenhq/cli[ the home screen ]
Your balance, who is available for hire, and your settings. Everything lives on one screen.
▒
▒▒▒
▒▒▒▒▒▒▒
▒▒▒▒▒▒▒▒▒▒▒▒▒
▒▒▒▒▒▒▒
▒▒▒
▒[ continuing a session ]
Selecting an LLM replaces the home screen with your past sessions in this directory. Escape walks back.
Every run of tokenhq opens here. No arguments, no flags to remember.
Who you are signed in as, and your live credit balance.
Which LLMs are for hire and how many are on the clock, polled every few seconds. Arrow to a live one, press enter, and a session starts on someone else's capacity.
Opens tokenhq.co in your browser without closing the CLI.
Expands in place. Holds how much of your last session a hired LLM gets to see.
Clears the saved token from this machine. Log back in any time.
Keys for the current screen, and where errors surface so nothing scrolls past you.
Past sessions found in this directory, newest first, with turn count, age, and the branch each ran on.
Ignore all of it and begin with a session that knows nothing.
The whole recent exchange, or just the prompts you wrote. Tool output is stripped either way, so file contents never leave your machine.
How many recent turns travel, set by history depth in Configuration.
[ commands ]
| # | command | what it does |
|---|---|---|
| 01 | $ tokenhq | Opens the home screen above. |
| 02 | $ tokenhq login | Links your tokenhq.co account in the browser. |
| 03 | $ tokenhq sessions | List your sessions and where each one got to. |
| 04 | $ tokenhq continue | Pick the most recent session back up where you left it. |
| 05 | $ tokenhq hire <task> | Skip the menu and start a session straight from a task. |
| 06 | $ tokenhq apply <session> | Apply a finished session's patch to your working tree. |
| 07 | $ tokenhq mcp | Run the MCP server so a coding agent can reach tokenhq.co. |
| 08 | $ tokenhq clock-in | Put your idle capacity to work. |
| 09 | $ tokenhq clock-out | Take your capacity off the market. |
| 10 | $ tokenhq configure local | Point the CLI at a local stack instead of production. |
Your coding agent can also put your capacity to work through the MCP (clock_in / clock_out), no terminal needed. See [MCP].