Skip to content

cli

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

cli

README.md

iohr, the InOrbit command line

iohr signs you in to InOrbit and calls its public API from a terminal, a script or CI. It also generates SDK surfaces cut to your account, installs signed extensions, sets up projects, and answers questions about the folder you are in with your own AI agent.

Status

Pre-release (0.x). Commands and output can still change between versions, and only the latest release receives fixes (support policy). The latest release is iohr/v0.1.0-alpha.38, published 2026-11-06 (releases, CHANGELOG.md).

These pages describe main. A change merged after the latest release ships with the next one. iohr-preview is the same program under another name, built ahead of a release and not published as a package; today it carries the ? modes, --role, the extension offer in iohr project init and iohr ext show with no name before a release does.

Install

brew trust inorbithr/tap                                          # once per machine: Homebrew refuses untrusted taps
brew install inorbithr/tap/iohr                                   # macOS, Linux
curl -fsSL https://packages.inorbit.hr/install.sh | sh            # Linux, macOS, no sudo
powershell -c "irm https://packages.inorbit.hr/install.ps1 | iex" # Windows

From a clone of this repository:

cargo install --locked --path cli/crates/iohr

The installers check every download against the release's SHA256SUMS. APT, upgrades, winget and how to check a release by hand are on Install and upgrade.

Quickstart

iohr login                      # opens InOrbit's sign-in page, or prints a link and a code
iohr whoami                     # subject, account, plan, scopes and expiry
iohr api GET /v1/me             # one API call as you
iohr sdk add                    # add the published SDK to the project in this folder
iohr sdk config                 # what an SDK client here would use, secrets redacted

iohr --help lists every command in five groups (Sign-in, Account, Build, Agents, Operate), and every command ends its --help with real examples.

Guides

Page What it covers
Install and upgrade Homebrew, the install scripts, APT, from source, iohr upgrade, checking a release
Sign in iohr login, accounts and teams, API tokens, IOHR_TOKEN, profiles, iohr auth token for other programs
Command reference Every command and its flags, the global flags, the help, usage errors and exit codes
SDKs and the API iohr sdk add, config, generate, check and examples; iohr api and iohr openapi
Domains and connections Proving a domain with DNS, connecting apps with a key or a browser sign-in, grants
Extensions Finding, installing, verifying and pinning extensions; building one with iohr ext init, dev and lint
Projects iohr project init, templates, the agent-built project, reading your public site, the atlas and iohr sync
Roles and memory Built-in roles, --role, and iohr memory as local files
Asking your agent iohr ask, the ? prompt in zsh, permission rules, the asks agents file for you
Sessions and the panel iohr session, iohr stop, bare iohr and the floating panel
The terminal theme iohr theme: the Mac app's terminal themes as a Terminal.app profile and a zsh prompt
Runner This machine as a coordinator runner on an Anthropic API key (your own plan for personal use only): capacity, upgrades, gate reports, approved run asks
Files, network and dependencies Where iohr keeps things, which hosts it talks to, and every runtime dependency with its reason

Guides with captured output are also on the developer site: what iohr can do, projects, the ? prompt, extensions and iohr and iohr-preview. These pages are the reference they link back to.

More

Licence

Apache License 2.0, see LICENSE.