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

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