apx-project

Register, configure, and manage APX projects via CLI commands and per-project config keys.

6|1|Updated May 8, 2026
One-click install
npx skills add https://github.com/agentprojectcontext/apx --skill apx-project-agentprojectcontext
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: apx-project
Source: https://github.com/agentprojectcontext/apx/tree/main/src/core/runtime-skills/apx-project
Command: npx skills add https://github.com/agentprojectcontext/apx --skill apx-project-agentprojectcontext

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing multiple AI agent projects in APX requires knowing which projects are registered, where their runtime state lives, and how to override per-project configuration without touching committed files. This Skill provides the exact CLI commands and safety boundaries for project registration, inspection, configuration, and memory management. ## Core Features & Use Cases - Project Registration & Inspection: Register APC-compliant folders with apx project add, list registered projects, and rebuild stale project scans. - Per-Project Configuration: Set dotted-key overrides like super_agent.model or telegram.route_to_agent that live in machine-local config and hot-reload the daemon. - Project Memory Management: Write durable notes with remember or full documents with write_project_memory, keeping private runtime memory out of committed .apc/ files. - Use Case: A user asks "what projects are registered?" — instead of guessing, you run apx project list, then set a project-specific model with apx project config set acme super_agent.model groq:llama-3.3-70b-versatile. ## Quick Start Ask the agent to list all registered APX projects and show the current configuration for one of them.

Frequently Asked Questions about apx-project

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I register a project in APX?▼

Run `apx project add /path/to/repo` on a folder containing AGENTS.md and .apc/project.json. If the folder is not yet scaffolded, run `apx init <path>` first, then add it — hand-writing those files breaks on rebuild.

How do I list registered APX projects?▼

Run `apx project list` to see each project's id, name, agent count, and path. When asked "what projects are there?", call the list_projects tool or this command instead of asking the user.

How do I set a per-project model or config in APX?▼

Use `apx project config set <project> super_agent.model <model>` with dotted keys. The project argument accepts a numeric id, exact name, or path, and every write triggers a daemon reload so no restart is needed.

Where does APX project memory get stored?▼

Local project memory lives at ~/.apx/projects/<apxId>/memory.md and is written by the remember or write_project_memory tools. The committed <repo>/.apc/memory.md is curated by the owner by hand — never write it yourself unless explicitly asked.

Why does my APX project break after moving its folder?▼

Moving a project's .apc/ folder leaves a stale apxId in the daemon's records. Run `apx project rebuild <id|path>` to force a re-scan of .apc/ and restore consistency.

Can I store API keys in .apc/project.json?▼

No. The .apc/project.json file is committed to git, and the daemon refuses credential-shaped keys there. Put machine-local secrets in the per-project config via `apx project config set` instead.