A composition format for portable AI agent distribution.
OAP defines a minimal, portable agent manifest (manifest.toml + prompt.md) that compiles to platform-native formats. Two files in, platform-ready agents out.
# From source
cargo install oap
# macOS (Homebrew)
brew install sahajamoth/tap/oap
# Script
curl -fsSL https://raw.githubusercontent.com/sahajamoth/oap/main/install.sh | sh# Create a new agent package
oap init my-agent
cd my-agent
# Edit manifest.toml and prompt.md, then:
oap validate .
oap compile --target claude-code -o out/| Platform | Compile | Import | Output Format |
|---|---|---|---|
| Claude Code | --target claude-code |
--from claude-code |
Markdown with YAML frontmatter |
| Codex | --target codex |
— | SKILL.md in agent directory |
| GitHub Copilot | --target copilot |
--from copilot-agent |
Markdown agent file |
| Cline | --target cline |
--from cline-rules |
Markdown rules file |
| Cursor | --target cursor |
--from cursor-rules |
.mdc with frontmatter |
| Windsurf | --target windsurf |
--from windsurf-rules |
Markdown with trigger |
| Aider | --target aider |
--from aider-conventions |
CONVENTIONS.md section |
| SKILL.md | --target skill |
--from skill |
SKILL.md with allowed-tools |
| Fleet Crew | — | --from fleet-crew |
— |
| Fleet Officer | — | --from fleet-officer |
— |
# Configure a marketplace
oap config add-market official https://github.com/sahajamoth/oap-market
# Search and install
oap search code-reviewer
oap install code-reviewer --target claude-code
# Publish your agent
oap publish --market /path/to/marketplace --pr# Scan for prompt injection patterns before installing
oap scan path/to/agentAgents declare abstract capabilities using cap: URIs that map to platform-specific tools:
[capabilities]
required = ["cap:file/read", "cap:code/search", "cap:shell/exec"]
optional = ["cap:agent/spawn"]# See how capabilities map to a platform
oap capabilities claude-code| Level | What You Need | What You Get |
|---|---|---|
| L0 | AGENTS.md |
Cross-platform instructions (already works) |
| L1 | manifest.toml + prompt.md |
Portable agent definition |
| L2 | + capability declarations | Platform-aware compilation |
| L3 | + tests + platform configs | Full portable package |
OAP absorbs upstream protocol drift at the adapter layer. Historical analysis shows all 35+ upstream changes across MCP, A2A, Claude Code, OCI, and Agent Skills resolved at L0-L2 (zero L3/L4 impacts). See spec/STABILITY.md.
Alpha — Working CLI with compile, import, search, install, publish, and scan across 8 platforms. Manifest format is stabilizing. Feedback and contributions welcome.
MIT OR Apache-2.0 (dual-licensed)