Installation

Requirements

• Node.js 18+
• Python 3.9+ (the context engine runs in Python)
• gh CLI (optional, for GitHub issue/PR integration)
• Your own LLM provider keys for whichever agent you run (Claude, Codex, Cursor)

Install

npm install -g @useagentrail/cli

This installs the agentrail command (also available as useagentrail).

Log in (required)

agentrail login

login links this machine to your AgentRail workspace via an OAuth device flow and saves credentials to ~/.agentrail/credentials.json. Login is required to use the CLI — the only exempt commands are login, logout, whoami, and --help. Sign up at app.useagentrail.com if you don't have an account yet.

Verify

agentrail doctor

doctor checks your installation health and reports anything missing. Run agentrail with no arguments to see the full command list.