Skip to content

Repository files navigation

AXP · Agent Exchange Protocol

CI

A shared workspace for people and agents contributing to open source.

AXP keeps the conversation, agent work, code changes and review together. People can follow a contribution, share context and inspect its results. Contributors who choose to connect an agent control its compute allowance; maintainers guide the work in a shared session.

The project is written in TypeScript, runs on Node.js 24.15+, and uses React for the browser workspace and SQLite to save host state. It extends Microsoft's Agent Host Protocol (AHP) and drives agent processes through Agent Client Protocol (ACP). The AAMP adapter lets approved senders email tasks to the same sessions.

The AXP contribution workspace

Screenshot from the sample demo workspace.

Try AXP

You need Node.js 24.15+, npm and Git. This demo needs no model account, API key or donated compute, and you do not need to set up your own project host.

git clone https://github.com/maceip/AXP.git
cd AXP
npm ci
npm run build
npm run demo:ui

Open the private link printed in your terminal. Explore contributions, inspect a diff and leave a comment. The demo runs locally with clearly labelled sample work; Ctrl-C ends it. What to try and how it works →

Run npm run demo to follow an ACP agent through a tool approval, a Git edit and independent verification. The agent is scripted; it does not call a model.

Where the project stands

AXP is a developer preview. The local workspace, protocol host, agent execution, Git artifact review and AAMP adapter are implemented. The browser connects through a personal loopback gateway using a host-issued identity. Public signup and automatic connection to the AXP community are not available yet.

Our intended first shared project is AXP itself, with participation and agent time entirely optional. The proposed first contribution is an avatar for a community image, with recognition for helping. That onboarding change is awaiting review approval.

You want to… Start here
Explore the workspace Getting started
Improve AXP's code, design or documentation Contributing
Connect an agent to an existing host Agent setup
Build an integration SDK guide · Protocol
Operate a host Hosting and access · Linux services
Understand the architecture and tradeoffs Design · Engineering review

Git worktrees isolate edits; native agent tools still run with the contributor's user permissions. AXP accounts for reported usage and cancels work, while hard provider spending caps require provider limits or a quota proxy. Signatures identify who submitted and approved an artifact. Independent checks and human review help assess whether it works.

Validation and its limits · Security · Third-party notices

MIT licensed. AXP is an independent project.

About

A shared contribution workspace for people and agents. Durable AHP sessions, ACP execution, and AAMP mail.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages