Installation

APX ships as a single npm package that provides three binaries: apx (CLI), apx-daemon (the local server), and apx-mcp (the MCP server bridge).

Requirements

• Node.js 20+ (the package engines field allows 18+, but 20+ is recommended).
• macOS, Linux, or WSL. Some surfaces (Desktop, Voice) have extra OS-level dependencies covered on their own pages.

Install

npm

npm install -g @agentprojectcontext/apx

pnpm

pnpm add -g @agentprojectcontext/apx

Tip

The daemon starts automatically on your first apx call — you don’t need to launch it by hand.

Verify

1. Check the CLI is on your PATH:

   apx --version

2. Run any command to boot the daemon, then confirm it’s healthy:

   apx status

   apx

   $ apx status
     Daemon
   ✓ running   port 7430   v1.38.0   uptime 3m
   
   Super-agent
   ✓ enabled
     model           anthropic:claude-sonnet-4-5
   
   Engines
   ✓ Anthropic     ← active
   ✓ OpenAI
   ✓ Gemini
   ✓ Ollama        http://localhost:11434
   
   Projects
   #1  First Project    5 agents   ~/code/first-project
   #2  Acme Store        4 agents   ~/code/acme-store
   #3  Data Pipeline     3 agents   ~/code/data-pipeline

   apx status showing the daemon running and its port

What gets created

The first run creates the local runtime directory:

~/.apx/
├── config.json        ← engines, providers, global settings
├── identity.json      ← the assistant's user-facing name (default "APX")
└── projects/          ← per-project runtime state (sessions, messages, caches)

None of this is committed — it’s local to your machine. See Configuration for the full reference.

Next

Head to the Quick start to initialize a project and run your first agent.