Reference
API surfaces, configuration, protocol contracts, and implementation specifications — organized for operators and contributors.
Sections
- Core concepts — architecture, feature tiers, planning vs execution
- Protocol v2.1 — uniform envelope, approvals, HATEOAS, two-phase commit
- Tools & configuration — MCP tool surface and
CLAWQL_*environment variables - Plugin model & registry — extension contract, horizontal plugins, shipped vs planned
- Plugins hub — dedicated page per plugin (memory, documents, bundled providers, …)
- Contributor specification — Effect-TS contracts, CRD fields, CI enforcement
Protocol reference
Uniform envelope, approval flows, HATEOAS.
MCP tools
search, execute, audit, cache, memory, optional tools.
mcp-api-adapter
Any MCP server → OpenAPI, GraphQL, /mcp, gRPC, and gen-cli from one catalog.
Configuration
CLAWQL_* env vars, spec loading, provider presets.
Plugins
Searchable registry — horizontal building blocks and vertical presets.
Optional tools hub
Cache, schedule, notify, Onyx, sandbox walkthroughs.
Bundled API specs
Provider presets and CLAWQL_PROVIDER values.
GraphQL layer
OpenAPI→GraphQL projection vs native GraphQL sources.
NATS JetStream
Optional event backbone for coordination.
Contributor spec
Implementation contracts, Effect-TS, CRD fields, CI.
Benchmarks
Planning-context comparisons and workflow artifacts.