Eidolon Capabilities
Quickstart
Quickstart
Prerequisites
- Node.js 20+
- A running AI agent (any framework)
1. Install
npm install -g @eidolondb/capabilities
# or run the server directly:
git clone https://github.com/millbj92/EidolonCapabilities
cd EidolonCapabilities && pnpm install && pnpm dev2. Create your first capability
Create capabilities/github.issue.create.yaml:
apiVersion: eidolon.dev/v1
kind: Capability
metadata:
name: github.issue.create
version: 0.1.0
spec:
description: "Create a GitHub issue"
inputSchema:
type: object
required: [repo, title]
properties:
repo:
type: string
description: "owner/repo"
title:
type: string
executor:
type: http
http:
method: POST
url: "https://api.github.com/repos/{{input.repo}}/issues"
headers:
Authorization: "Bearer {{secret.GITHUB_TOKEN}}"
Accept: "application/vnd.github+json"
body:
title: "{{input.title}}"
policy:
allowedActors:
- "agent:dev"
rules:
- effect: require_approval
when:
environment: prod3. Set up secrets
export EIDOLON_SECRET_KEY=your-32-char-key
eidolon secrets set GITHUB_TOKEN ghp_yourtoken4. Plan an action
eidolon capabilities plan github.issue.create \
--input '{"repo": "acme/app", "title": "Fix login bug"}' \
--actor agent:devOutput:
{
"status": "ok",
"decision": "allowed",
"riskScore": { "score": 25, "level": "low" },
"policyChecks": [...]
}5. Apply it
eidolon capabilities apply github.issue.create \
--input '{"repo": "acme/app", "title": "Fix login bug"}' \
--actor agent:devThat's it. Your agent now has audited, policy-controlled access to GitHub.