The fastest way to configure is:
/calibrate
This scans your codebase and sets up agents, skills, and hooks to match your project’s patterns. It’s safe to run multiple times.
Add custom agents as .md files in your project’s .claude/agents/ directory.
These run alongside the plugin agents.
Add custom skills as directories in .claude/skills/. Each skill needs a
SKILL.md file with frontmatter.
To override any plugin-provided file:
.claude/ directory (it’s a symlink from the plugin)Your override won’t be touched by future plugin updates.
| You need… | Install |
|---|---|
| Full dev workflow (planning, implementing, QA, PRs) | forge |
| Bug fixing only | scalpel |
| Project setup and onboarding | spark |
| SRE and incident response | sentinel |
| Deep QA testing | prism |
| Safety guardrails (no skills, hooks only) | shield |
| Design workflows | canvas |
| Product management | compass |
| Consulting toolkit | counsel |
| Autonomous mode | cruise (requires forge + scalpel + sentinel) |
| Everything | prime |
You can install multiple bundles. They compose without conflicts:
/plugin install forge@arthai-marketplace
/plugin install sentinel@arthai-marketplace
/plugin install prism@arthai-marketplace
The sentinel bundle includes the otel-telemetry hook and /otel-setup skill for tracing every Claude Code session.
/otel-setup
The skill prompts for your preferred setup. Pick “Local” — this is the only option available right now.
Prerequisite: Docker Desktop installed and running.
The skill pulls arthai/intelligence from Docker Hub, starts the engine + dashboard + Postgres, and configures everything automatically.
The skill writes these env vars to .claude/settings.local.json (project-local, git-ignored) by default, or to your shell profile if you pick the global scope:
| Variable | Required? | Purpose |
|---|---|---|
CLAUDE_CODE_ENABLE_TELEMETRY=1 |
Required for cost data | Enables Claude Code’s native OTEL emitter — only path that produces cost USD, input/output/cache tokens, and model. Without this, dashboard cost columns stay empty. |
OTEL_EXPORTER_OTLP_ENDPOINT |
Required | Where spans and metrics are sent (e.g., http://localhost:4319 for the local Docker collector). |
OTEL_EXPORTER_OTLP_PROTOCOL=http/json |
Required | Native OTEL defaults to gRPC/protobuf, which most simple HTTP collectors reject silently. http/json is the format Arth Intelligence and most plain HTTP collectors accept (#304). |
OTEL_EXPORTER_OTLP_HEADERS |
Optional | Auth headers (e.g., Authorization=Bearer <key>) — needed for cloud-hosted collectors only. |
OTEL_METRICS_EXPORTER=otlp |
Required | Route native metrics (cost / tokens) to OTLP. |
OTEL_LOGS_EXPORTER=otlp |
Required | Route native logs to OTLP. |
OTEL_TRACES_EXPORTER=otlp |
Required | Route native traces to OTLP. |
The hook captures 22 Claude Code event types:
/skill-name)Critical spans (session.end, agent.stop) are sent synchronously with a 1s timeout for reliable delivery. All other spans are fire-and-forget (<10ms overhead).
If the hook is installed but OTEL is not configured, it automatically prompts you to run /otel-setup on your next session start. This only fires once — after setup, a marker file (~/.arthai/otel-configured) prevents re-prompting.
export OTEL_DISABLED=true
When a new version is released:
/plugin marketplace remove arthai-marketplace
rm -rf ~/.claude/plugins/cache/*arthai*
/plugin marketplace add ArthTech-AI/arthai-marketplace
/plugin install forge@arthai-marketplace
/reload-plugins