One Horizon CLI
Use One Horizon from your terminal to manage tasks and send task context into coding tools.
Installing
Install the CLI package globally and run one --help:
npm install -g @onehorizon/cliIf you do not want a global install, use:
npx @onehorizon/cli --helpSigning in
Run one auth login to sign in, then run one ws to pick your active workspace.
After sign-in, one list shows your open work and one dashboard opens the active workspace in your browser.
If the browser does not open during one auth login, copy and open the printed URL yourself. The login callback waits for a short time, then exits if no callback arrives.
Managing work
The CLI supports the core task flow:
one listto review workone show <id>to inspect detailsone start <id>,one status <id> <status>, andone close <id>to update progressone comment <id> "..."to add updatesone create "..."to create new work
Picking tasks faster
If you omit a task ID, interactive commands only show actionable tasks and sort them based on the command context.
one reopen only shows Completed, Cancelled, and Merged tasks.
one reopen is for closed work only. Use one status or one start if the task is still active.
Sending to coding tools
Use one send <id> to build a prompt from the task and launch a coding tool.
Supported launch targets include Codex, Cursor, Windsurf, and Claude Code. You can pass --tool and --mode directly or pick them interactively.
If you use Claude Code, install One Horizon Desktop so the one:// launch link can open on your machine. See Claude Code for setup details.
You can also review related guides for Codex, Cursor, and Windsurf.
Configuring settings
Run one settings to inspect your saved CLI preferences for the active workspace.
Use one settings tool add <tool> and one settings folder add <path> to save preferred launch targets and working folders.