Skip to main content

​
Before You Start

  • Codex CLI installed and working. See Requirements for the minimum version.
  • A Nito account. If you do not have one, nito agent signup opens the signup page once you finish step 1.

​
Install

1

Install the nito command line tool

Install it globally with npm (requires Node.js 18 or newer):
2

Run setup

It keeps the plugin version-matched to your command line tool and bundles the hook that Private and Session need.
3

Approve access

Setup opens your browser. Sign in and approve.You may be asked twice, once for the terminal and once for the connection that powers in-chat commands. Anything you approved before is skipped.If the browser does not open, setup prints a URL you can visit instead.
4

Trust the hook

Codex will not run a new or changed hook until you review it, so it shows a startup notice about the Nito hook. That notice is expected. In Codex, run:
Review the Nito hook and trust it. This approves local code execution for $nito:private and $nito:session, and it is separate from your Nito sign-in rather than a second login.
That is the whole install. The plugin is ready in Codex and there is nothing further to run inside it. Go straight to your first ask.

​
What Setup Just Did

  • Installed the plugin and pinned it to the same version as your command line tool, so the two cannot drift apart.
  • Approved access for the terminal and for in-chat commands.
  • Logged you in, so later private and session launches use your account without anything to reconfigure.
  • Bundled the hook that lets $nito:private catch a prompt before Codex sends it anywhere. That is why the one-time trust step exists.
Codex triggers commands with a $ rather than a /.

​
Next

Your First Private Prompt

Run a prompt your harness never sends upstream.

Check Your Setup

Confirm everything is healthy with status and doctor.