BUGDROP.
    DEV
    Terminal-first

    BugDrop CLI

    A terminal-first workflow for managing annotations and applying AI fixes without leaving your editor. Registers the bugdrop:// protocol handler so Apply Fix links open your terminal automatically.

    INSTALLATION & AUTH

    bash
    $ npm install -g @bugdrop/cli
    $ bugdrop auth sk-bd-<your-api-key>
      ✓ Authenticated as dev@example.com

    LINKING A PROJECT

    Run from your project's root directory. Saves a .bugdrop.json file.

    bash
    $ bugdrop init
      ◉ Fetching projects...
      Select project:
      ❯ bugdrop-web  (preview.bugdrop.io/abc123)
        mobile-app
        docs-site
      ✓ Linked to bugdrop-web

    COMMAND REFERENCE

    The CLI provides specific commands to manage annotations without entering the interactive TUI.

    INTERACTIVE TUI

    Run bugdrop ui (or just bugdrop) to open the full-screen terminal UI. The layout is a 6-row block-pixel logo at the top, a subtitle bar showing project + annotation count, then a 2-panel layout: a 26-wide sidebar menu on the left and a scrollable detail panel on the right.

    text
    ██████╗ ██╗   ██╗ ██████╗ ██████╗ ██████╗  ██████╗ ██████╗
    ██╔══██╗██║   ██║██╔════╝ ██╔══██╗██╔══██╗██╔═══██╗██╔══██╗
    ██████╔╝██║   ██║██║  ███╗██║  ██║██████╔╝██║   ██║██████╔╝
    ██╔══██╗██║   ██║██║   ██║██║  ██║██╔══██╗██║   ██║██╔═══╝
    ██████╔╝╚██████╔╝╚██████╔╝██████╔╝██║  ██║╚██████╔╝██║
    ╚═════╝  ╚═════╝  ╚═════╝ ╚═════╝ ╚═╝  ╚═╝ ╚═════╝ ╚═╝
    ─────────────────────────────────────────────────────────────────────
     v0.1.0 · Project: proj_012ab3  · 8 annotations
    ─────────────────────────────────────────────────────────────────────
      › Init Project            │ Select an action from the menu.
        List Annotations        │
        View Details            │ Tip: Use bugdrop init to link a project.
        Preview Diff            │
        Apply Fix               │
        Resolve                 │
        Open in Browser         │
        Export                  │
        Settings                │
        Quit                    │
    ─────────────────────────────────────────────────────────────────────
     Focus: Actions  ·  Tab to switch  ·  Q quit  ·  C clear

    TUI Shortcuts

    APPLYING AI FIXES

    From terminal

    Review diffs and apply fixes directly via CLI subcommands.

    bash
    $ bugdrop diff ann_01HZ
    # Shows the unified diff
    $ bugdrop apply ann_01HZ
      ✓ Patch applied: src/Checkout.tsx

    From dashboard

    Click Apply Fix on any annotation. Your OS routes the bugdrop:// URL to the CLI automatically — no copy-pasting.