Sensu AI — VS Code Extension
Live observability for AI agents, directly in your editor. See active runs, token usage, cost, and latency without leaving VS Code.
Features
Status Bar
A live indicator in the bottom-right of your editor updates every 30 seconds:
⚡ Sensu ▶ 3 ⌨ 2.4K/m $0.12 ⚠ 1
│ │ │ └─ errors
│ │ └─ cost today
│ └─ tokens per minute
└─ active runs
Click it to open your Sensu dashboard in the browser.
A collapsible panel in the Explorer sidebar with two sections:
Live
| Metric | Description |
|--------|-------------|
| Active runs | Runs currently in progress across all agents |
| Tokens / min | Rolling token throughput |
| Cost today | Cumulative LLM spend since midnight |
| Avg latency | Mean time-to-completion across recent LLM calls |
| Errors today | Failed runs and tool errors |
Plan & Quota
| Metric | Description |
|--------|-------------|
| Tokens used | Tokens observed this billing period |
| Token limit | Monthly cap for your plan |
| Usage | Percentage of quota consumed |
| Resets | Date the quota resets |
Commands
| Command |
Description |
Sensu: Open Dashboard in Browser |
Opens sensu-ai.com in your default browser |
Sensu: Configure API Key |
Prompts for your API key and saves it to settings |
Sensu: Refresh Metrics |
Manually triggers a metrics fetch |
Getting Started
- Install the extension from the VS Code Marketplace
- Run
Sensu: Configure API Key from the command palette (⌘⇧P / Ctrl+Shift+P)
- Paste your API key — create one at sensu-ai.com/settings
- Metrics appear in the status bar and sidebar immediately
Configuration
All settings are under the sensu namespace in VS Code settings:
| Setting |
Default |
Description |
sensu.apiKey |
"" |
Your Sensu API key (sk-...) |
sensu.apiUrl |
https://api.sensu-ai.com |
API base URL — change only if self-hosting |
sensu.dashboardUrl |
https://sensu-ai.com |
URL opened by "Open Dashboard" |
sensu.pollIntervalSeconds |
30 |
How often metrics refresh (minimum: 10) |
You can set these in your settings.json directly:
{
"sensu.apiKey": "sk-your-key-here",
"sensu.pollIntervalSeconds": 15
}
Integrating your agents
The extension reads from the Sensu API — your agents need to send telemetry for data to appear.
TypeScript SDK
npm install @sensu-ai/sdk
import { SensuClient } from '@sensu-ai/sdk';
const sensu = new SensuClient({ apiKey: process.env.SENSU_API_KEY });
const run = sensu.startRun({ agentId: 'my-agent' });
await run.end('completed');
LangChain
import { SensuCallbackHandler } from '@sensu-ai/sdk/integrations/langchain';
const handler = new SensuCallbackHandler({ apiKey: process.env.SENSU_API_KEY });
await chain.invoke({ input }, { callbacks: [handler] });
REST API
curl -X POST https://api.sensu-ai.com/api/v1/events \
-H "X-API-Key: $SENSU_API_KEY" \
-H "Content-Type: application/json" \
-d '{"type":"llm.request.completed","agentId":"my-agent","tokensIn":512,"tokensOut":128}'
Full API reference: sensu-ai.com/docs
Requirements
Support
