Sovereign agent nodes first. Framework details second.

---

Plaited is a framework for building local-first sovereign agents.

The current direction is:

• one agent per workspace
• a minimal behavioral core in src/agent
• module-composed behavior for planning, memory, skills, MCP, A2A, and verification
• portable skills under skills/ and workspace installs under .agents/skills
• a bootstrap CLI that turns infrastructure decisions into an executable setup surface

Core Shape

Plaited's shipped runtime is centered on:

• create-agent.ts
• behavioral.ts
• bootstrap.ts
• eval.ts
• ui.ts

The core owns:

• behavioral engine setup
• signal installation
• heartbeat and snapshot surfaces
• built-in file and inference handlers
• module installation

Higher-level orchestration belongs in modules.

Active Directions

• AGENT-LOOP.md
• INFRASTRUCTURE.md
• ARCHITECTURE.md
• dev-research/README.md
• Kernel/eval backlog issues (repo workflow): #258 and #261-#270

Repository Map

• src/ — shipped framework code
• skills/ — published and reference skills
• docs/ — concise design docs
• dev-research/ — retired research tombstone and historical artifacts

Notable skill surfaces:

• plaited-ui

Development

Requirements:

• Bun >= v1.2.9
• git

Useful commands:

# Typecheck
bun --bun tsc --noEmit

# Full test suite
bun test

# Bootstrap a local deployment scaffold
bun run ./bin/plaited.ts bootstrap '{"targetDir":".","name":"my-agent"}'

# CLI schema discovery
bun run ./bin/plaited.ts --schema

Skills

Skills are the portable agent-facing extension surface.

• published skills live under skills/
• workspace-installed skills should live under .agents/skills/
• runtime composition still happens through modules

Repo planning intake is GitHub Issue-backed; local execution/decomposition is handled in Cline/Kanban after maintainer label-gating and review.