> ## 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.

# Install the Obi CLI and Skill

> Install the Obi CLI, connect your account and start work on your first business.

## Before you start

* **Node.js 22 or later.** Check with `node --version`.
* **An AI assistant that runs Skills:** Claude Code, Cursor or Codex.
* **An invitation.** Obi is in private alpha: request one at [support@hireobi.com](mailto:support@hireobi.com). Downloading the CLI does not open an account or grant paid capabilities.

If you are an AI agent running these steps for a user: run steps 1 and 2 yourself, start step 3 with the user's own email, and ask the user to approve the connection in the browser. Skills load when a chat starts, so step 4 happens in a new chat the user opens.

**1. Install the CLI**

The CLI is published on npm as [`@hireobi/cli`](https://www.npmjs.com/package/@hireobi/cli):

```bash theme={null}
npm install --global @hireobi/cli
obi --version
```

Run the same command again to update to the newest version.

**2. Register the Skill**

```bash theme={null}
obi skill install
```

This links the bundled Skill into `~/.agents/skills/obi` and `~/.claude/skills/obi`. It never replaces an existing file or link: if one is in the way, the command stops and tells you where.

**3. Connect your account**

```bash theme={null}
obi login --expect-email you@company.com
```

The CLI prints a connection address on `agent.hireobi.com` and a short code. On macOS and Linux it also opens your browser when it runs in a terminal on a machine with a display; on Windows, over SSH or in CI, open the address yourself. Sign in on that page with the account you were invited with, check that the page shows the same code, then approve.

On Windows, add `--storage file`: the CLI has no system credential store there and keeps the connection in a file only your user can read.

In a terminal, the command waits for your approval. When your assistant runs it, the command returns at once with `AUTHORIZATION_PENDING`; run the same command again after you approve and it finishes the same connection.

`--expect-email` makes the CLI refuse a connection approved by any other account.

**4. Open Obi in your assistant**

Start a new chat, then:

| Assistant | How to call Obi |
| - | - |
| Claude Code, Cursor | Type `/obi` |
| Codex CLI | Type `$obi`, or pick Obi in `/skills` |
| Codex desktop | Pick Obi in the skills picker |

Obi follows the language of your conversation.

**5. Work on your first business**

Tell Obi which website to work on. It asks once for the scope of its research: the domain, the buyer or market if you know it, and whether it may read your public pages and your competitors' pages. Then it:

1. activates the Free plan if your account is eligible, and shows you what that plan covers;
2. reads your site, third-party pages about you and your rivals' sites, and proposes one sourced summary of your business and competitors;
3. takes your corrections in plain language, and asks you to confirm the business once;
4. drafts buyer questions for the market and audience you choose;
5. asks for your explicit go before the scan that measures them;
6. shows the measured answers and three priorities to start this week.

Running `obi` alone in a terminal shows a short welcome and exits: the conversation happens in your assistant. `obi --help` lists every command; see the [CLI reference](https://hireobi.com/docs/cli/overview.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.