apx

Orchestrates agents, sessions, and channels through the APX CLI and local daemon.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coordinating multiple coding CLIs (Claude Code, Codex, OpenCode, Aider) and APX-managed agents from inside an active session requires knowing the exact APX commands, channels, and relay conventions; this Skill gives an engine the correct command surface so it never invents subcommands or misuses channels. ## Core Features & Use Cases - Super-agent execution: Run one-shot prompts via apx exec on cli, code, or custom channels, with persistent code sessions that can be resumed by id. - Agent-to-agent relay: Send messages to APX agents (including the super-agent) with apx send --deliver, keeping threaded history and enabling replies back into your session via apx session resume. - State inspection: Query daemon health, registered projects, cross-engine sessions, curated agent memory, and message logs with apx status, apx sessions list, apx memory, and apx messages tail. - Use Case: While working in Claude Code, the user says "preguntale a Roby que me avise cuando termines" — you send an a2a message with your engine and session id, get Roby's reply on stdout, and Roby can later inject a follow-up directly into your transcript. ## Quick Start Ask the agent to check APX daemon health and list active sessions by running apx status and apx sessions list for the current project.

Frequently Asked Questions about apx

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

FAQPage Schema
How do I send a message to an APX agent from Claude Code?▼

Use apx send with the a2a channel: apx send <you> <agent> "<message> engine=claude session=<id>" --deliver. The --deliver flag runs the recipient and returns its reply on stdout, and including your session id lets the agent answer back into your session later.

How do I run a one-shot prompt with the APX super-agent?▼

Run apx exec "prompt" for the default cli channel, or apx exec --code "prompt" for a coding session with git and code tools. The code channel prints a session id on stderr that you can reuse with --session to continue the conversation.

What is the difference between apx exec and apx send?▼

apx exec posts on the user channel, so the agent treats the message as if the user typed it. apx send uses the agent-to-agent channel, preserving thread history between the two parties and enabling proper relay replies.

Can APX resume a Claude session with a reply message?▼

Yes, the agent side runs apx session resume <session-id> --continue --msg "<reply>" to inject one message into your transcript and capture your response on stdout. Resume with --msg is currently Claude-only.

Why should I avoid guessing APX subcommands?▼

The skill instructs engines to confirm exact command forms with apx --help and apx <command> --help before use. If a subcommand does not appear in the help output, it does not exist and should not be invoked.

When should I not use the apx skill?▼

Do not activate it for pure .apc/ directory reading, which belongs to the apc-context skill, or for MCP details like scopes and secrets, which belong to the apx-mcp skill. Prefer native IDE or CLI tools for tasks that are not APX-specific.