Install
Install Harbor in your coding agent
One command in your terminal. Correct an agent once, and every agent on your team gets the rule.
$npx harborloop initSend this to my computerSign in
Run it in the repo you work in. Your browser opens to sign in, or to create an account if you have none, then sends you back to the terminal.
What you’ll see
Start a new session in your agent. In Claude Code and Codex, its first prompt shows a line that starts with ⚓ and names your workspace. Cursor and GitHub Copilot have no place for that line, so look in Harbor: on the Get started page, the session step ticks once your first prompt reaches it.
Check it worked
npx harborloop doctorchecks the sign-in, the hooks and this repo, and names whatever is missing.GitHub Copilot in VS Code
Start the harbor MCP server once: MCP: List Servers, harbor, Start Server.
Prefer a plugin?
Claude Code and Codex also install Harbor as a plugin. It sets up that one agent, where npx harborloop init sets up every agent it finds.
$claude plugin marketplace add gethrbr/harbor-plugins && claude plugin install harbor@harborSend this to my computerSign in
In Claude Code, in your repo, type
/harbor:login. Your browser opens to sign in, or to create an account if you have none, then sends you back to the terminal.What you’ll see
Start a new Claude Code session. On its first prompt Harbor shows a line that starts with ⚓ and names your workspace.
$codex plugin marketplace add gethrbr/harbor-plugins && codex plugin add harbor@harborSend this to my computerSign in
In Codex, in your repo, type
$harbor:login. Your browser opens to sign in, or to create an account if you have none, then sends you back to the terminal. It also trusts the plugin’s hooks for you.What you’ll see
Start a new Codex session. On its first prompt Harbor shows a line that starts with ⚓ and names your workspace.
Cursor has a plugin too (cursor-agent plugin marketplace add https://github.com/gethrbr/harbor-plugins, then install Harbor from /plugins), but that last step is a click in Cursor, so we recommend init. For GitHub Copilot, use init only: Copilot reads the Claude Code plugin file in Harbor’s plugin repo and installs the wrong plugin.
Before you start
- Node 18 or later. Every route runs Harbor’s setup through npx.
- Run it in the repo you work in. Setup turns Harbor on in that repo, and leaves every other repo alone.
- No account yet? The sign-in makes one. Or create it first and install after.
- The full walk-through is in the quickstart, and every command in the CLI reference.