Install the CLI

Install the Cofactor CLI.

The cofactor CLI drives everything in this product from your terminal — suites, browser sessions, sandboxes, releases, issues — and it's how your coding agent drives Cofactor too.

01Install

bash

npm install -g @runcofactor/cli

Or with bun:

bash

bun add -g @runcofactor/cli

Verify it landed:

bash

cofactor --version

Installing the CLI and verifying the version

02Upgrade

The install command is also the upgrade command — it always fetches the latest published version:

bash

npm install -g @runcofactor/cli

03Troubleshooting

command not found: cofactor — your global npm/bun bin directory isn't on PATH. Find it with npm bin -g (or bun pm bin -g) and add it to your shell profile.
Permission errors with npm — prefer a user-writable npm prefix or a Node version manager over sudo npm install.
Corporate proxy in the way? After installing, cofactor auth doctor diagnoses connectivity and proxy issues.

04Next steps

CLI authentication — connect the CLI to your organization
CLI Quickstart — from empty terminal to a passing test in five steps