Vraxis

One local command center for the Vraxis ecosystem.

Vraxis finds your installed apps, agent runtimes, local Agent Skill files, and agent work launched through Vraxis. It gives you one clean place to see what is ready and open what you need.

Getting started

npm install -g @vraxis/cli
vraxis

Vraxis requires Node.js 22.12 or newer.

What you can see

• Installed Vraxis apps
• Agent runtimes supported by agent-v
• Agent runs launched and tracked by Vraxis
• Discovered local skills for Codex, Claude Code, Cursor, OpenCode, shared Agent Skills directories, plugins, and the current project

Vraxis does not scan every process on your computer or claim ownership of unrelated agents. If another tool launches an agent outside Vraxis, that process stays outside the “running agents” view.

Commands

vraxis status
vraxis apps
vraxis agents
vraxis skills
vraxis skill-sources
vraxis runtimes
vraxis install aperta
vraxis install home
vraxis update aperta
vraxis open read

Add --json to any read-only command for machine-readable output.

vraxis skills shows which runtimes can see each skill and whether its manifest is ready for strict agent-v execution. vraxis skill-sources shows every native, shared, project, plugin, cache, and configured location checked. Remote OpenCode catalogs are reported but never downloaded during local discovery.

App registry

Vraxis ships with a small, reviewed app registry. Each entry maps a stable app ID to its npm package and executable, so the CLI never guesses what to install.

| App ID | npm package | Command | |---|---|---| | read | @vraxis/reader | vraxis-read | | home | @vraxis/home | vraxis-home | | distribution-os | @vraxis/distribution-os | distribution-os | | aperta | @vraxis/aperta | aperta | | archnode | archnode | archnode |

Run vraxis install <app-id> to install the mapped package globally. Run vraxis update <app-id> to install its latest published version. Registry changes ship through reviewed CLI releases, so package ownership cannot change silently at runtime.

Long installs and updates show elapsed time while npm is working. If npm fails, Vraxis keeps the useful error and shows the next command to check.

Keyboard shortcuts

Inside the command center:

• Number keys 1 through 5 or the arrow keys change the view.
• Up/down arrows or j/k move through a list.
• Enter installs a missing app or opens an installed app.
• u updates the selected installed app.
• r refreshes local state.
• ? shows help.
• q quits.

Local data

Vraxis orchestration state lives in ~/.vraxis/orchestrator. Provider keys and other secrets do not belong in the run registry.

Development

npm install
npm run dev
npm run check

The project uses Vue for reactive terminal state, Node.js for discovery and launching, and agent-v for runtime and Agent Skills contracts.