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
By default this installs the skill for OpenCode. Choose a different agent, or install for all of them, with --target:
Shell

​
Supported agents

Each target installs the same skill into that agent’s default skills directory: Two more flags adjust where and how the skill is installed: skill update and skill status take the same --target and --dir flags, for a skill in a custom location. --dir works with one target at a time. status checks every agent by default, so pass a single --target along with --dir.

​
Keep the skill up to date

An installed skill records the version of the bundled skill it came from. The skill has its own version number, separate from the CLI’s. After you upgrade appsignal-cli, refresh your installs to the bundled version:
Shell
Like install, update acts on OpenCode by default; pass --target to update a different agent or all of them.
Shell

​
Check installation status

To see whether your installed skills are current, outdated, or missing:
Shell
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. status lists each install with one of these statuses, then prints the bundled skill version: Before CLI version 2.2.0, an installed skill recorded the CLI version instead of a skill version. status reports those installs as update_available.

​
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.