# bd-cli

Use this skill to work with live bitdrift account data through the bd CLI. It guides investigations into crashes and sessions, as well as workflow and alert management.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 596 installs · ★ 13
- Author: bitdriftlabs
- License: LicenseRef-PolyForm-Shield-License-1.0.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/bitdriftlabs/bd-skills/tree/HEAD/skills/bd-cli/SKILL.md
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/skills/bd-cli

## What it does

The skill routes tasks to `bd` commands for finding workflows and charts, reading metrics, investigating issue groups, and inspecting sessions. For guide-backed work, it locates relevant instructions with `bd guides`; `bd schema` provides the current request and response fields.

The `bd` CLI must be installed. Interactive sign-in uses `bd auth`, while automation can use `BD_API_KEY`. Guide routing requires `bd` version 0.2.43 or newer, so check `bd --version` if guides are unavailable. An API key should never go into a command, transcript, or report.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add bitdriftlabs/bd-skills --skill bd-cli -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/bd-cli/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/bd-cli/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add bitdriftlabs/bd-skills --skill bd-cli -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/bd-cli/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add bitdriftlabs/bd-skills --skill bd-cli -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/bd-cli/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install bitdriftlabs/bd-skills bd-cli
```

2. **Manually: put the files in place**
- File: `.github/skills/bd-cli/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add bitdriftlabs/bd-skills --skill bd-cli -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/bitdriftlabs/bd-skills --path skills/bd-cli
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/bd-cli/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add bitdriftlabs/bd-skills --skill bd-cli -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/bitdriftlabs/bd-skills/tree/HEAD/skills/bd-cli/SKILL.md

## When to use it
- find a workflow and its chart IDs
- read metric charts and check their completeness
- investigate issue groups and occurrences
- locate captured sessions and inspect their logs
- create or manage workflow alerts

## Example prompts
- Investigate the app's crash groups and find related sessions.
- Find the workflow chart and check whether its data is complete.
- Set up an alert for this workflow.

## Similar
- [cx-alerts](https://affpapa.org/en/nevibecode/skills/cx-alerts.md) — skill · 3600 installs
- [authoring-log-alerts](https://affpapa.org/en/nevibecode/skills/authoring-log-alerts.md) — skill · 356 installs
- [cargo-observability](https://affpapa.org/en/nevibecode/skills/cargo-observability.md) — skill · 6200 installs
- [pump-analyzer-solana](https://affpapa.org/en/nevibecode/skills/pump-analyzer-solana.md) — skill · 837 installs
- [news-monitor](https://affpapa.org/en/nevibecode/skills/news-monitor.md) — skill · 5100 installs
- [Weather Automation](https://affpapa.org/en/nevibecode/skills/weather-automation.md) — skill · 4500 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md