Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.devhelm.io/llms.txt

Use this file to discover all available pages before exploring further.

DevHelm ships a bundle of agent skills that give Cursor, Claude Code, Claude Desktop, and other Anthropic-skill-compatible hosts first-class knowledge of the platform. After installing them, an AI agent can answer “why is my checkout monitor red?” with a real forensic trace, publish an incident update to your status page, or stand up a new notification policy — all from the chat window, in your repo context. Skills are bundled with the DevHelm CLI (devhelm) and installed with one command.

​
What’s in the bundle

SkillWhat it does
devhelm-configureCreate & manage monitors, alert channels, notification policies, resource groups, dependencies, secrets, webhooks, environments. Auto-detects Monitoring as Code (YAML or Terraform) vs imperative CLI.
devhelm-investigateRead-only diagnostic: list check results, pull incident forensic traces, correlate failures across regions, query uptime, read the audit log. Never mutates state.
devhelm-communicateStatus pages: create pages, add components & groups, configure custom domains, manage subscribers, publish incident updates. Requires explicit human confirmation before any public-facing write.
devhelm-manageWorkspace administration: API keys (list, create, rotate, revoke), environments, entitlements/plan inspection, team roster.
Each skill is self-contained and follows Anthropic’s progressive-disclosure convention — the top-level SKILL.md stays under 500 lines; resource-specific detail lives in references/ files that the agent loads on demand.

​
60-second install

1

Grab your API key

Copy an API key from Settings → API Keys — a starter key named Default is created for you during onboarding; you can create additional ones or rotate them anytime. All API keys start with dh_live_ and have full access to the organization.
2

Install the CLI

npm install -g devhelm
# or run one-off: npx devhelm skills install
3

Install skills for your agent

npx devhelm skills install
This auto-detects Cursor, Claude Code, and other MCP-compatible hosts installed on your machine and copies the skill bundle into the right place. To target a specific host, pass --target cursor | claude-code | claude-desktop | generic.For Claude Desktop, which ships skills as uploaded bundles:
npx devhelm skills bundle --out ~/Downloads/devhelm-skills.zip
Then import the zip from Claude Desktop → Settings → Skills → Add skill.
4

Authenticate

Export your key so the CLI — invoked by the skill — can call the API:
export DEVHELM_API_TOKEN=dh_live_xxxxxxxx
Or, if you prefer a local context file:
devhelm auth login
5

Verify

Open a chat in your agent and ask:
“Use the devhelm-investigate skill to list my monitors and their status.”
You should see the agent read @references/check-results.md, run devhelm monitors list, and return a structured summary. If it can’t find the skill, run devhelm skills doctor to diagnose.

​
Skills vs MCP server — which to use?

DevHelm offers two AI integrations. They’re complementary, not exclusive.
AI SkillsMCP Server
DeliveryMarkdown files bundled with the CLILong-running server process
ProtocolAgent reads SKILL.md and calls the devhelm CLIAgent calls tools over the Model Context Protocol
Best forImperative workflows, Monitoring-as-Code edits, PRs, code reviewRead-heavy dashboards, live context during a coding session
TransportLocal process (agent shells out)Local process (stdio) or hosted (mcp.devhelm.io)
StateStatelessStateless per request
Run both together if you like. The skills know about the MCP server and will defer to it for pure read paths when it’s installed.

​
Safety rails baked in

Every skill enforces the same guarantees:
  • Never print API key values into chat output, commits, or logs.
  • Never publish a status-page incident update without explicit, single-turn confirmation.
  • Never edit devhelm.yaml without showing the diff first.
  • Always prefer plan / dry-run before any deploy or apply.
See the skill source in the CLI repo for the full list.

​
Next

Configure each host

Cursor, Claude Code, Claude Desktop — the exact install paths, env vars, and verification steps.

Example prompts

Copy-paste prompts that hit each of the four skills end-to-end.