> ## Documentation Index > Fetch the complete documentation index at: https://hireobi.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Obi CLI commands > The obi commands and their options, as the installed CLI accepts them. Commands accept `--json`, and the commands that call your account accept `--timeout-ms <100-30000>` (see [global options](https://hireobi.com/docs/cli/overview.md#global-options)). Commands that start paid work or approve your review take an explicit confirmation flag, such as `--confirm-scan` or `--confirm-review`, so they never run by accident. `obi --help` prints the full grammar of your installed version. ## Account and setup ### status ```bash theme={null} obi status ``` Reads your connected account and the next step it is waiting for. `AUTH_REQUIRED` means this machine is not signed in. ### login ```bash theme={null} obi login --expect-email [--storage file] ``` Connects this machine to your account through the browser; see the [quickstart](https://hireobi.com/docs/quickstart.md#connect-your-account). `--expect-email` is required when the command does not run in an interactive terminal. `--storage file` keeps the connection in an owner-only file instead of the system credential store, and is required on Windows. ### logout ```bash theme={null} obi logout ``` Signs this machine out. ### credentials ```bash theme={null} obi credentials list obi credentials revoke [--force] ``` `list` shows the live CLI connections of your account that you may see, most recently used first, with each device label, CLI version and dates. `revoke` ends one connection. Revoking the connection this machine uses is refused unless you add `--force`, which also signs this machine out. ### skill ```bash theme={null} obi skill install obi skill path ``` `install` links the bundled Skill into `~/.agents/skills/obi` and `~/.claude/skills/obi`, and never replaces an existing entry. `path` prints where the bundled Skill is. ### doctor ```bash theme={null} obi doctor ``` A local diagnostic that sends no request: your Node.js version, the CLI version, the server origin it is pinned to, where the connection is stored, and whether the video tools `yt-dlp` and `ffmpeg` are installed. ### capabilities ```bash theme={null} obi capabilities --json ``` The commands, actions and options this installed version supports, and the version of the expertise its Skill carries. ## How Obi's work reaches your account Obi researches your business, writes your buyer questions and reasons over your results in your assistant. The Skill reads the work your account expects with `harness show` and saves your assistant's result with `harness submit`, stage by stage: `business`, then `questions`, then `strategies`. See [Harness work](#harness-work). Because your assistant does this work, the server-side commands `business start`, `business discover`, `questions prepare` and `questions edit` are refused with `HARNESS_REQUIRED` or `HARNESS_QUESTIONS_REQUIRED`. ## Business These commands display and correct the business review. All of them except `show` act on the review version you last displayed: pass the `--snapshot ` that `business show` returned, and read `business show` again after each change. ```bash theme={null} obi business show obi business clarify-identity --snapshot --company obi business clarify-fact --snapshot --field-path --text --company --company-wide [--segment-name ] obi business challenge --snapshot --reason obi business correct --snapshot --claim-id --field-path --text --company --company-wide obi business add-competitor --snapshot [--reason ] obi business remove-competitor --snapshot [--reason ] obi business readd-competitor --snapshot [--reason ] obi business remove --snapshot [--reason ] obi business confirm --snapshot --confirm-review ``` | Action | What it does | | - | - | | `show` | Displays the current review: identity, summary, target buyer, competitors, with sources | | `clarify-identity` | Sets the company name | | `clarify-fact` | Answers a missing fact for the whole company; `--segment-name` names a buyer segment you add | | `challenge` | Disputes a sourced claim, with a reason | | `correct` | Replaces a sourced claim with your correction | | `add-competitor`, `remove-competitor`, `readd-competitor`, `remove` | Change the competitor set | | `confirm` | Confirms the review once; it does not start a scan | See [Business review](https://hireobi.com/docs/how-it-works/business.md). ## Questions and scans ```bash theme={null} obi questions show obi questions proceed --candidate-version --confirm-scan obi questions results [--run latest|first|] [--from ] ``` | Action | What it does | | - | - | | `show` | The current question set, its version and its preparation state | | `proceed` | Starts the scan of the displayed question version | | `results` | The measured answers, with engines, dates and citations | `proceed` needs both the version you reviewed and `--confirm-scan`. After a timeout, run `questions show` before anything else. `results` reads the latest completed scan and lists your scans, newest first. `--run first` or `--run ` reads another one; a long scan comes in pages, and `--from` reads the same scan from a later question. See [Buyer questions](https://hireobi.com/docs/how-it-works/questions.md) and [Scans and engines](https://hireobi.com/docs/how-it-works/scans.md). ## Readiness and strategies ```bash theme={null} obi readiness obi strategies ``` `readiness` reads the saved [Readiness report](https://hireobi.com/docs/how-it-works/readiness.md); it never starts a new reading. `strategies` reads your saved [priorities](https://hireobi.com/docs/how-it-works/strategies.md). ## Memory ```bash theme={null} obi memory list obi memory add --kind --text "" obi memory remove ``` What Obi remembers about how you work, across assistants and sessions: a preference ("answer in French"), a constraint ("never propose rival X") or a decision ("French market first"). Business facts are not memory: they live in the sourced review and its corrections. ## Harness work The Skill runs these for you; you rarely need them yourself. ```bash theme={null} obi harness coverage obi harness activate --free obi harness show --stage [--packs <1-40>] obi harness submit --stage --input obi harness evidence --work-id [--kind claims|sections|measurements] [--cursor ] [--query ] [--url ] [--all --output ] obi harness artifact --work-id [--input ] [--revision ] [--output ] [--cursor ] [--limit <1-100>] obi harness outcomes --task-id [--cursor ] [--limit <1-50>] obi harness observe --input obi harness purchase [--input ] [--confirm-checkout] [--confirm-change] ``` | Action | What it does | | - | - | | `coverage` | Your plan's question and engine coverage, and whether the Free plan can be activated | | `activate --free` | Activates the Free plan on an eligible account; starts no scan | | `show` | The work context of a stage: work ID, version, allowed sources, next batch | | `submit` | Saves your assistant's result for a stage | | `evidence` | Searches the saved facts, page sections or scan measurements of a work; `--all` exports them to a file | | `artifact` | Saves, shows, lists the revisions of, or exports a draft | | `outcomes` | Reads the outcomes recorded for a saved task | | `observe` | Records an implementation you confirmed | | `purchase` | Quotes a first plan for reviewed questions, prepares its checkout, reads its status, resumes it, or changes an existing paid plan | `purchase prepare` requires `--confirm-checkout` and returns a checkout page on `agent.hireobi.com`, which it opens in your browser when it can. `purchase resume` takes the quote ID only and never starts a second checkout. `purchase change` changes the packs or engines of an existing paid plan. Without `--confirm-change` it only previews the change and charges nothing: the amount due now for an increase, or the date a reduction takes effect. The same command with `--confirm-change` applies that previewed change. See [Plans](https://hireobi.com/docs/plans.md#changing-your-packs). ## Local research helpers These run on your machine and write local files; they send nothing to your account and take no `--timeout-ms`. ```bash theme={null} obi research crawl --checkpoint --output [--batch-size <1-100>] [--locale ] [--pages priority|all] [--max-pages ] [--retry-failed|--refresh] obi research capture --input --checkpoint --output obi research readiness --input --output obi research video --output [--frames <0-30>] ``` | Action | What it does | | - | - | | `crawl` | Reads a site's pages in resumable batches, keeping its progress in the checkpoint file | | `capture` | Adds a page your assistant's browser observed to the corpus | | `readiness` | Writes a Readiness report from a corpus | | `video` | Saves a video's metadata and one caption track, plus up to 30 still frames, to the directory; needs `yt-dlp`, and `ffmpeg` for frames | Reading through your machine shows what that machine sees; it does not prove what an AI provider's crawler can reach. ## Operator evaluations ```bash theme={null} obi eval start obi eval list ``` Authorized Obi operators can evaluate a public company in an isolated case, then add `--eval-case ` to `status`, `business`, `harness`, `readiness`, `questions`, `strategies` and `memory`. An evaluation does not prove ownership of that company's website. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.