# acpx

Tooling for the [Agent Client Protocol](https://agentclientprotocol.com) on top of [`acpx`](https://www.npmjs.com/package/acpx).

This is a Bun-managed monorepo. Packages live under [`packages/`](./packages).

## Packages

| Package | Description |
|---|---|
| [`acpx-ai-provider`](./packages/acpx-ai-provider) | Vercel AI SDK provider on top of `acpx/runtime`. One install, any ACP agent (Claude, Codex, Copilot, Cursor, Pi, …). |
| [`acpx-ai-harness`](./packages/acpx-ai-harness) | Vercel AI SDK v7 `HarnessV1` adapter on top of `acpx/runtime`. Plugs any ACP agent into the [AI SDK Harnesses](https://ai-sdk.dev/v7/docs/ai-sdk-harnesses/overview) ecosystem alongside `@ai-sdk/harness-claude-code`, `@ai-sdk/harness-codex`, and `@ai-sdk/harness-pi`. |
| [`ai-sdk-microsandbox`](./packages/ai-sdk-microsandbox) | Vercel AI SDK v7 `HarnessV1SandboxProvider` backed by [microsandbox](https://github.com/superradcompany/microsandbox). Drop-in replacement for `@ai-sdk/sandbox-vercel`, running coding agents in local microVM isolation instead of hosted infrastructure. Pre-release scaffold; provider implementation lands in later releases. |
| [`agent-skills-manager`](./packages/agent-skills-manager) | Programmatic workspace + agent-link manager for skills following the [agentskills.io specification](https://agentskills.io/specification). Manifest-driven `add` / `link` / `unlink` / `listSkills` / `listLinks` / `rescan` primitives. |
| [`agent-mcp-manager`](./packages/agent-mcp-manager) | Programmatic `add` / `link` / `unlink` / `remove` / `listServers` / `listLinks` / `rescan` for MCP servers across AI coding agents (Claude Code, Claude Desktop, Cursor, VS Code, Codex, Zed). Manifest-backed, library not CLI. |
| [`acp-probe`](./packages/acp-probe) | Probe any ACP-compatible agent for its capabilities — models, modes, configOptions, prompt capabilities, auth methods, MCP transports — via a single typed `probeAgent({ command })` call. No real prompt sent; no token cost. |

## Development

Requires [Bun](https://bun.sh) ≥ 1.3.

```bash
bun install
bun run typecheck
bun run lint
bun test
bun run build
```

## Tooling

- [**Bun**](https://bun.sh) — package manager, test runner, workspace orchestrator
- [**Bunup**](https://bunup.dev) — library bundler for `packages/*`
- [**Biome**](https://biomejs.dev) — formatter + linter
- [**Fallow**](https://docs.fallow.tools) — codebase intelligence: unused code, circular deps, package boundary enforcement

## License

MIT © Dani Akash