AgentSpec VS Code Extension

VS Code extension for AgentSpec — the universal manifest standard for AI agents.

Features

Schema autocomplete — full agent.yaml completion via JSON Schema, plus provider-aware model ID suggestions
Inline diagnostics — validate on save; ZodError paths mapped to line/column squiggles
Cluster view — live sidebar tree of AgentObservation CRs with health status and compliance grade
Agent detail panel — click any agent to see health summary, conditions, and top violations
CLI commands — run agentspec health, audit, generate from the command palette
Status bar — phase + grade pill when agent.yaml is the active editor

Requirements

agentspec CLI installed and on $PATH
kubectl configured for cluster view features
ANTHROPIC_API_KEY set for AgentSpec: Generate Code

Configuration

Setting	Default	Description
`agentspec.cliBinPath`	`"agentspec"`	Path to agentspec CLI binary
`agentspec.kubeNamespace`	`""`	Kubernetes namespace to watch (empty = all)
`agentspec.refreshInterval`	`30`	Cluster view refresh interval (seconds)

Commands

Command	Description
`AgentSpec: Validate`	Validate the nearest `agent.yaml`
`AgentSpec: Health Check`	Run runtime health checks
`AgentSpec: Audit`	Run compliance audit
`AgentSpec: Generate Code`	Generate framework code via Claude
`AgentSpec: Refresh Cluster`	Refresh cluster agent list

Cluster View

The explorer sidebar shows all AgentObservation custom resources:

AgentSpec Agents
├── 📁 demo
│   └── 🟢 gymcoach     A · 95    Healthy    2s ago
└── 📁 production
    ├── 🟡 budget-bot   B · 78    Degraded  15s ago
    └── 🔴 risk-agent   F · 32    Unhealthy  1m ago

Click any agent to open the detail panel with health conditions and violation breakdown.

AgentSpec