An agentic operating system.
The hub — a multi-tenant control plane — manages tenants,
principals (users and agents under one authorization model),
capability grants, credentials, and agent lifecycle. Agents under
hub management run in sidecars that drive a harness on the hub's
behalf. The agent runtime — @intx/agent
and the family of packages around it — runs anywhere from a
long-lived server to a Cloudflare Worker, swapping implementations
of storage, cryptography, message transport, tools, and payments to
match the environment. Both ends share the type definitions in
@intx/types.
What you build on top is up to you. A coding assistant. A mail-driven workflow agent. An autonomous trader. A research harness.
| You want to… | Go to |
|---|---|
| Use the agent runtime in your own program | examples/ |
| Understand how the packages fit together | LAYOUT.md |
| Run the full stack (hub + sidecar + admin UI) locally | DEV.md |
| Write code in this repository | CONVENTIONS.md, AGENTS.md |
| Read the system design | docs/ — ARCHITECTURE.md, and friends |
Run the full stack with seed data:
bin/db-reset && bun bin/dev.ts --seedStarts the hub, sidecar, and admin UI — entry points in
apps/.
Requires Bun 1.2+ and PostgreSQL 15+. See
DEV.md for everything else — environment files, role
setup, default ports, seed credentials, partial-stack variants,
reset recipes.
Build, lint, test, and format go through the Makefile at the repo
root, which verifies the environment via
bin/check-env before delegating to the
underlying bun run scripts.
| Target | Description |
|---|---|
make all |
lint + build + test (full verification) |
make build |
type check (tsc -b --noEmit) |
make lint |
prettier + eslint + API docs freshness |
make format |
auto-format |
make test |
run tests |
make docs |
regenerate docs/API.md |
make clean |
remove tsbuildinfo, dist/, and env stamp |
Run make all before declaring a change correct; individual
package builds do not guarantee the full project graph compiles.
The hub exposes a REST API at http://localhost:3000. The OpenAPI
spec is at GET /openapi.json; the human-readable reference is
generated into docs/API.md by
bin/gen-api-docs.ts from ArkType
introspection over the type definitions in
@intx/types.