Activate Avorelo

Activation is a local command. It looks at the project you run it in, detects the AI coding tools and models you already use, applies safe setup fixes, writes run-entry guidance for future sessions, and records local state so you do not have to configure everything by hand.

What activation is not

It is not account activation. There is no account, no sign-up, and no activation server. Nothing is registered anywhere.

It is not licence activation. Activation contacts no licensing server and performs no online licence check. Your rights come from the Apache License 2.0, not from running this command — see the licensing note below.

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, local browser proof.
  4. Applies safe fixes — creates local Avorelo directories, adds a .gitignore block, writes the activation contract.
  5. Installs run-entry guidance — adds a marker-managed Avorelo block to CLAUDE.md, AGENTS.md and supported instruction surfaces. Your own content is preserved.
  6. Shows first value — what was found, what was fixed, what is ready, what needs attention, and what to do next.

The local commands

These are the commands the workflow is built around. They all run locally against the project directory you are in.

avorelo activate

Detects the workspace, applies safe fixes and writes local activation state. Use --scope to control how widely it applies.

avorelo status

Shows activation and session status for the current project.

avorelo open

Opens the local receipts viewer, reading local files only. See the local viewer page for what it shows.

avorelo doctor

Health check across adapters, hooks and session state.

avorelo update-check

The one command that deliberately reaches the network: it makes a bounded request to the npm registry to see whether a newer version exists. Nothing else in the workflow contacts a network service on its own. The command is update-check, written with a hyphen.

No account required

Activation is local-first. Everything runs on your machine, there is no sign-up and no cloud service, and your project data does not leave it.

Installation and licensing status

Avorelo is Open Source under the Apache License 2.0. Install the release candidate with npm install -g avorelo, or build from source.

Older Avorelo versions published to npm under an earlier hosted product are not this local-first Apache-2.0 release; use avorelo@latest (1.0.0 or newer).

Apache-2.0 permits personal, internal, organizational, and commercial use, including modification and redistribution, subject to the license terms. No fee and no separate license are required. See the license page.

See the local viewer Capabilities Back to home