Docs/CLI/AI agent skill

AI agent skill

Use the bundled skill when you want an AI coding agent to drive the TrackFox CLI correctly — commands, flags, output formats, and exit codes — instead of guessing. It covers both querying analytics and managing your site: Discord/Telegram automation alerts, conversion funnels, saved segments, and server-side payment attribution.

Install the skill

trackfox skill install

This writes .claude/skills/trackfox-cli/SKILL.md into the current project. Claude Code (and other agents that read .claude/skills/) picks it up automatically on the next session.

Target a different project

trackfox skill install --dir ../other-project

Reinstall after an upgrade

trackfox skill install --force

The skill is bundled with the trackfox package, so upgrading the CLI and reinstalling keeps it in sync with the latest commands.

Good to know

The skill documents the CLI's behavior — it doesn't grant the agent API access on its own. Agents still need a configured profile (trackfox config add) or TRACKFOX_WEBSITE_ID/TRACKFOX_API_KEY in the environment to actually run commands.

A handful of commands (automation, funnel create/delete, segment create/delete, attribute-payment) write to your site instead of just reading from it. The skill tells the agent to confirm with you before running one of these, but the API key it uses has full access to those actions — treat it the same way you'd treat dashboard access when deciding who gets that key.

This skill only helps agents that can run shell commands, like Claude Code. If you want to use TrackFox from Claude Desktop, or any other MCP client, run it as an MCP server instead — same credentials, same underlying commands, exposed as tools instead of a CLI reference.

Need help? Contact us for assistance.

Suggest features? We'd love your feedback