Skip to content

index.md

Latest commit

 

History

History
70 lines (52 loc) · 2.6 KB

index.md

File metadata and controls

70 lines (52 loc) · 2.6 KB
Raw

Developer documentation — Capas

Build extensions for oc8: connectors, tool packs, agent templates, skills, runtimes, approval channels, and Claude-compatible plugins.

If you change oc8 core (runtime, authz, database), see Contributing instead.

Start here

Step Document
1. Understand capa types Plugin types
2. Build your first capa Tutorial: first capa
3. Manifest reference Manifest reference
4. Test locally Testing capas

Guides

Topic Document
Architecture (author's view) Architecture overview
Manifest fields (plugin.toml) Manifest reference
Capa types and contributions Plugin types
Dependencies and requirements Dependencies and requirements
Guardrails and permissions Guardrails and permissions
Setup forms and OAuth Setup forms and OAuth
Packaging and distribution Packaging and distribution
Claude Agent SDK plugins Claude plugin capas
Testing Testing capas

Exhaustive on-disk reference

The flat reference for folder layout, lifecycle, and every manifest field:

→ capas/README.md

Quick start

  1. Create capas/<capa_id>/ — folder name must equal manifest name.
  2. Add plugin.toml and/or a Claude plugin layout.
  3. Discovery rescans on request — restart not required. Install and enable per tenant from the Capas UI; accept permission consent.

Capa types (summary)

Type Purpose
tool_pack MCP connections (disconnected until configured)
agent_template One hireable agent
department_template Team + frame starter
skill Procedures materialised on enable
connector Knowledge source (RAG ingest)
runtime_adapter Alternative agent runtime (Docker)
approval_channel Messenger approvals

Tests

cd backend
uv run pytest tests/plugins/test_discovery.py -q
uv run pytest tests/plugins/test_claude_plugin_bridge.py -q

Fixtures: backend/tests/plugins/fixtures/.

Related