@agentprojectcontext/apx

[!WARNING] APX v1 is no longer maintained. APX v2 replaces it: a new desktop app, a phone app and a one-line install for your server, rebuilt from scratch. It brings your v1 projects, agents and chats along. Meet APX v2 → · curl -fsSL https://agentprojectcontext.github.io/apx/install.sh | bash

Meet your crew.

APX is an open-source Agent OS: your own team of AI agents, running on your machine.
Give them roles, memory and tools. Talk to them, let them work together, and follow what they do.
Research, writing, everyday plans, business operations or code — build a crew around your life and work.

See APX working → · Install v1 · APX v2 · Español · Discord

See your crew in action

_{A real recording of APX v1 running a demo crew. Watch more recorded workflows on the website.}

Each agent gets a blobo — its own face — alongside a role, memory, skills and tools. Mention one in a conversation and it can pick up the work or ask another agent for help. The faces make your crew easy to recognize; the recorded workflows show what it actually does.

What you can do

• Keep a crew for each part of your work. A researcher, a writer, an organizer or a coding agent: choose the roles you need and group them by project.
• Give work to the team. Start a group chat, mention an agent in a task, and follow its reply. Agents can ask each other for help.
• Put recurring work on a schedule. Daily briefings, reports and check-ins can run as routines while APX stays running.
• Reach the same crew from different places. Use the web panel, Telegram, WhatsApp or your phone; your agents keep their roles and access to their tools.
• See the work as it happens. Conversations show agent actions, and the panel brings chats, tasks, routines and code sessions together.
• Bring your models and tools. Connect model providers, local Ollama models, skills and MCP servers. For coding work, delegate to Claude Code, Codex or another supported CLI.

APX runs on your machine. Connected cloud models and services receive the data needed for the requests you send them; local operation does not mean every model runs offline.

Why APX?

The reason to try APX is the crew workflow: recognizable agents, roles organized around your projects, shared conversations, delegated work, tasks and routines in one place. A project can be a business, a creative project, a personal workspace or a codebase. You do not need a Git repository to start using APX.

If you already use OpenClaw or another agent app, local execution, markdown files and messaging integrations alone are not a reason to switch. Compare the experience: does APX make your particular team easier to organize, work with and follow? Watch a real workflow and try it with one task that matters to you.

For code projects, agent definitions, skills and shared project context can travel with the repository. Conversations, sessions, credentials and private runtime memory stay outside it.

Quick start

This repository and these installation commands are for APX v1. Requires Node.js 22+ on macOS, Linux or Windows.

npm install -g @agentprojectcontext/apx
apx setup

The setup wizard helps you choose a provider, a model and your channels, starts APX, and prints your panel address. Open http://localhost:7430 in your browser.

Start with one agent and one real task. Add specialists and routines as you need them. Cloud providers require their own access or credentials; local models require a configured local provider.

Prefer the terminal? From a project folder:

apx init
apx agent list
# Replace <agent> with an agent listed above.
apx exec <agent> "Help me plan the next steps for this project"
apx run <agent> --runtime claude-code "Review this project and suggest improvements"
apx run <agent> --runtime codex "Add tests for the parser"

Coding commands require the selected external CLI to be installed and authenticated.

On your phone

The panel fits your phone too. apx panel share gives you a network address; apx panel tailscale on lets you reach it through your tailnet. Open the panel on your phone and add it to your home screen.

There is also a native Android app, with notifications, a floating mascot and Android Auto:

• Download the Android APK.
• Or connect your phone by USB and run apx android install.
• Read the installation guide.

The Android app installs from a file, outside Google Play. On iPhone, use the web panel. USB access lasts while the cable is connected; LAN access stays within your network; Tailscale connects devices on your tailnet.

APX v2 replaces v1

v1 is no longer maintained. APX v2 takes APX further as a standalone application for your crew: install it from its website or the main branch. The v1 commands above install v1, not v2.

_{Real V2 interface running a scripted demo with fictional data: agent-to-agent delegation, an interactive widget and a live browser page. View the light-mode capture.}

These are the direction and current development experience, not a promise that every v1 feature has already reached parity.

How V2 works

flowchart TB
    You[You: desktop, phone or messaging] --> Main[Your main agent]
    Main <--> Crew[Specialists and project crews]
    Main --> Core[One APX core]
    Crew --> Core
    Core <--> Tools[Models, skills and connected tools]
    Core <--> Browser[Desktop browser: watch or take over]
    Core <--> Work[Conversations, tasks, routines and apps]

One core owns the work and history; the app, phone and messaging channels connect to it. Your main agent can work directly or delegate to a specialist. The desktop supplies its browser, where you can see the page and take control. This keeps the crew together as you move between devices.

Follow the website and Discord for V2 progress and release news.

Documentation and community

• Website and recorded demos
• User documentation
• Discord community
• Report a bug or suggest an improvement

Where APX started

APX began as a way to make APC — Agent Project Context work in practice: portable agent definitions, skills and project instructions in AGENTS.md and .apc/. It grew into an application with its own crew, conversations, tasks, routines, channels and interfaces. APX is the product you use today; APC is part of its origin and project-context foundation.

You do not need to learn the protocol to use APX. If you want the technical background, read the APC specification.

For contributors, start with AGENTS.md. APX v1 has a local daemon, a CLI, a web panel and bridges to external tools. Project context can live in the project folder; runtime state lives under ~/.apx/, outside the repository.

License

MIT