---
name: bounty-cli
description: |
  Bounty gives AI agents a safe, authenticated marketing operations CLI for
  campaign performance, ads, creatives, actions, and agent workflows. Use this
  onboarding skill from the Bounty app domain to install the CLI skills,
  authenticate, and choose the right Bounty skill path.
---

# Bounty CLI

Bounty helps marketing teams and AI agents inspect paid performance, creative
fatigue, campaign details, generated actions, and agent runs from the terminal.

## Bounty Surfaces

- **App** - https://app.bountygrowth.com/ is the authenticated Bounty product
  app for logged-in users.
- **Landing page** - https://www.bountygrowth.com/ is the public Bounty
  marketing site.
- **Docs** - https://docs.bountygrowth.com/ contains public product
  documentation.
- **Open-source CLI** - https://github.com/bounty-growth/cli contains the CLI
  for LLMs and AI coding agents.

## Install

One command installs the Bounty CLI skills into detected AI coding agents and
opens browser auth so the human can sign in.

```bash
npx -y bounty-cli@latest init --all --browser
```

This gives you:

- **CLI access** - `bounty-cli campaigns`, `bounty-cli ads`, `bounty-cli creatives`, `bounty-cli actions`, `bounty-cli agents`
- **Marketing skills** - `bounty-cli`, `bounty-campaigns`, `bounty-ads`, `bounty-creatives`, `bounty-actions`, `bounty-agents`, `bounty-campaign-analysis`
- **Browser auth** - normal Bounty sign-in with a local CLI callback

After install, restart the AI agent so it discovers the new skills.

## Verify

```bash
bounty-cli whoami
bounty-cli campaigns list --json
```

If either command says you are not logged in, run:

```bash
bounty-cli login
```

## Choose Your Path

- **Need a broad CLI workflow** -> use `bounty-cli`
- **Need campaign performance or campaign lists** -> use `bounty-campaigns`
- **Need ad-level performance or a specific ad** -> use `bounty-ads`
- **Need creative analytics or fatigue** -> use `bounty-creatives`
- **Need generated marketing actions** -> use `bounty-actions`
- **Need agent definitions or agent run context** -> use `bounty-agents`
- **Need prioritized findings for one campaign** -> use `bounty-campaign-analysis`

## Manual Skill Install

If the CLI is already installed and authenticated, install or refresh the
skills directly:

```bash
bounty-cli setup skills
```

The skill source is:

```bash
npx skills add bounty-growth/skills --full-depth --global --all --yes
```

## Notes For Agents

- Use `--json` when you need machine-readable output.
- Start with list commands, then use show/analyze commands for detail.
- Use explicit date ranges when comparing performance.
- Do not ask for Supabase, warehouse, or service-role credentials. The CLI uses
  the logged-in user's normal Bounty permissions.