Claxedo

claxedo.com · npm: @claxedo/*

Claxedo is an open-source coding-agent workspace for running OpenCode, Claude, Codex, Cursor, Pi, and other coding agents against your own projects. It combines first-class chat and terminal sessions, remote workspace access, sandbox management, MCP tooling, and an optional standards-based Agent Plugins catalog.

Quickstart

Clone the repo and run the desktop app or the engine directly:

git clone https://github.com/kyashrathore/Claxedo.git
cd Claxedo
bun install
bun run dev             # desktop app (Electron shell)
bun typecheck           # turbo typecheck across the workspace

The runtime packages remain independently installable for Node and Bun projects:

npm install @claxedo/workspace-runtime @claxedo/agent-sdk-runtime @claxedo/agent-event-runtime

Most full products start with @claxedo/workspace-runtime; the package table below links directly to each published module.

Packages

All 12 are published on npm under @claxedo/*:

Package	Description
@claxedo/workspace-runtime	Per-workspace host runtime for agent sessions, terminals, processes, files, diffs, and relay attachment
@claxedo/agent-runtime-contract	Dependency-free canonical contracts for Claxedo agent sessions, content, execution, errors, and events
@claxedo/agent-sdk-runtime	Runtime facade over coding-agent harnesses (Claude, Codex, Cursor, OpenCode, Pi): sessions, turns, SSE routes, pluggable stores
@claxedo/agent-event-runtime	Canonical agent event contracts and harness adapters normalizing Claude SDK, Codex, Cursor, and ACP event streams into one event model
@claxedo/workspace-relay	Relay/tunnel server that routes authenticated traffic to workspace runtimes, with Bun and Cloudflare adapters
@claxedo/workspace-relay-protocol	Wire types, message validation, and token verifier interfaces for the workspace relay tunnel protocol
@claxedo/sandbox-contract	Dependency-neutral sandbox driver identity and credential configuration contracts
@claxedo/sandbox-manager	Sandbox lifecycle manager with epoch-based leases and pluggable drivers for Daytona, Modal, Vercel Sandbox, Cloudflare, Box, and Docker
@claxedo/channels	Channel ingress routing GitHub, Slack, Telegram, Discord, and WhatsApp messages into Claxedo runtimes
@claxedo/connections	Integration registry, credential store ports, OAuth attempt machine, and token service for linking external accounts
@claxedo/mcp	MCP server and CLI for Claxedo documents, processes, logs, sessions, and browser tools
@claxedo/wakes	Resume an idle agent session from an out-of-band trigger — a durable wake fired by time, an external event, or an authorized approval

Layout

• packages/claxedo-server — hosted control plane (runs local/cloud/hybrid sessions; embeds the published OpenCode SDK host via @claxedo/workspace-runtime/opencode)
• packages/claxedo-local-server — the desktop's self-hosted server; packages/claxedo-server-core — storage- and vendor-agnostic core shared by both servers
• packages/claxedo-app — web app (Solid); packages/claxedo-desktop — Electron shell
• packages/workspace-runtime, workspace-relay*, sandbox-manager — session execution + routing
• packages/{channels,connections,wakes,mcp,agent-*} — first-party @claxedo/* capabilities
• packages/{ui,session-ui} — shared OpenCode UI used by the app and desktop
• packages/cli — the claxedo CLI (@claxedo/cli: login, connect, host, status, deploy, documents, logout); one-line install in its README

OpenCode heritage

Claxedo is a hard fork of OpenCode. Session execution uses the pinned published OpenCode SDK through packages/workspace-runtime; shared UI remains in-repo, while benchmark imports use the same published SDK. The control plane, workspace runtime, relay, channels, connections, and web/desktop apps are Claxedo's own.

Contributing

Security issues go through SECURITY.md, not a public issue.

License

MIT — see LICENSE.