Skip to main content
The CLI bundles an AppSignal agent skill: a set of instructions that teaches an AI coding agent how to use appsignal-cli to inspect your AppSignal data. Installing it writes a SKILL.md into the agent’s skills directory, so the agent knows when to reach for the CLI and how to read its JSON output.
The skill teaches an agent to run the CLI, so the agent acts as you. Make sure the CLI is authenticated on the machine where the agent runs.

​
Install the skill

Shell
appsignal-cli skill install
By default this installs the skill for OpenCode. Choose a different agent, or install for all of them, with --target:
Shell
# Claude
appsignal-cli skill install --target claude

# Codex
appsignal-cli skill install --target codex

# Every supported agent
appsignal-cli skill install --target all

​
Supported agents

Each target installs the same skill into that agent’s default skills directory:
TargetInstalls to
opencode (the default)~/.agents/skills/appsignal/SKILL.md
codex$CODEX_HOME/skills/appsignal/SKILL.md, or ~/.codex/skills/appsignal/SKILL.md when $CODEX_HOME is unset
claude~/.claude/skills/appsignal/SKILL.md
allAll of the directories above
Two more flags adjust where and how the skill is installed:
FlagDescription
--dir <path>Install into this skills root directory instead of the target’s default
--forceOverwrite an existing installed skill
skill update and skill status accept the same --target and --dir flags, so you can update or check a skill installed in a custom location.

​
Keep the skill up to date

An installed skill records the CLI version that produced it. After you upgrade appsignal-cli, refresh your installs to the bundled version:
Shell
appsignal-cli skill update
Like install, update acts on OpenCode by default; pass --target to update a different agent or all of them.
Shell
appsignal-cli skill update --target all

​
Check installation status

To see whether your installed skills are current, outdated, or missing:
Shell
appsignal-cli skill status
status checks all supported agents by default, so you get one list covering OpenCode, Codex, and Claude. Pass --target to narrow it to a single agent.

​
Next steps

The skill lets an agent run the CLI from your shell. For agents that talk to AppSignal directly over HTTP instead, see AppSignal MCP.