Activate Avorelo

Avorelo sets up your project automatically, detects the AI tools and models you use, fixes safe setup issues, prepares run-entry guidance for future sessions, and gives you a local dashboard so you do not have to configure everything manually.

npx -y avorelo@latest activate --scope project-wide --claim <activation_claim>

Replace <activation_claim> with the claim token from your dashboard. Claims expire in 15 minutes.

What activation does

  1. Detects your workspace — git repo, package manager, framework, scripts, tests.
  2. Detects AI coding tools — Claude Code, Cursor, Codex, AGENTS.md, CLAUDE.md, and more.
  3. Detects capabilities — skills registry, model routing, scanners, browser proof, billing env.
  4. Applies safe fixes — creates .avorelo directories, adds .gitignore block, writes activation contract.
  5. Installs run-entry guidance — adds marker-managed Avorelo block to CLAUDE.md, AGENTS.md, and supported instruction surfaces. Preserves your content.
  6. Shows first value — what was found, what was fixed, what's ready, what needs attention, and what to do next.

No account required

Activation is local-first and free. Everything runs on your machine. No credit card. No cloud signup. No data leaves your project.

After activation

Check your setup:

npx avorelo status

Having trouble?

Activation needs Node.js and npm. If your environment blocks the command, try these alternatives:

Windows PowerShell blocks npx

PowerShell execution policy can prevent npx from running scripts. Use Command Prompt instead:

cmd /c npx -y avorelo@latest activate --scope project-wide --claim <activation_claim>

npm cache or permission error

Use a temporary npm cache directory that matches your shell:

$env:npm_config_cache="$env:TEMP\npm-cache-avorelo"; npx -y avorelo@latest activate --scope project-wide --claim <activation_claim>
cmd /c "set npm_config_cache=%TEMP%\npm-cache-avorelo && npx -y avorelo@latest activate --scope project-wide --claim <activation_claim>"

Sandboxed AI runner (Codex, CI, etc.)

Some environments block remote npm package execution. Avorelo cannot self-heal when the runner prevents npm from starting. Run from a normal local terminal instead, or approve bounded remote package execution in a temporary directory.

Run preflight check

Diagnose your environment before activating:

npx avorelo@latest preflight
View dashboard See pricing Back to home