Claron CLI

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

INSTALLATION & AUTH

bash

$ npm install -g @claron/cli
$ claron auth bd_<your-api-key>
  ✓ Authenticated as dev@example.com

Get your API key

Dashboard sidebar Settings / Developer & API / Create Key. Copy it immediately — it's only shown once.

LINKING A PROJECT

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

bash

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

COMMAND REFERENCE

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

INTERACTIVE TUI

Run claron ui (or just claron) to open the full-screen terminal UI. The current Dev Cockpit brings navigation, project context, annotation triage, and developer actions together in a keyboard-first workspace.

text

██████╗██╗      █████╗ ██████╗  ██████╗ ███╗   ██╗
██╔════╝██║     ██╔══██╗██╔══██╗██╔═══██╗████╗  ██║
██║     ██║     ███████║██████╔╝██║   ██║██╔██╗ ██║
██║     ██║     ██╔══██║██╔══██╗██║   ██║██║╚██╗██║
╚██████╗███████╗██║  ██║██║  ██║╚██████╔╝██║ ╚████║
 ╚═════╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝╚═╝  ╚═══╝
────────────────────────────────────────────────────────────────────────────────
DASHBOARD      Tab / → Enter content  ↑↓ / jk Select view  q Quit       Unauthorized
◆ CLARON  |  ● OFFLINE  |  master*  |  0 annotations
────────────────────────────────────────────────────────────────────────────────
NAVIGATION                  DEVELOPER COCKPIT  |  Focused console for code review
┃ ◆ Dashboard               
  ◉ Annotations             TOTAL         OPEN       CRITICAL      AI FIXES
  ◇ Diff                      0            0            0             0
  Studio                    
  ✦ Apply Fix               SETUP HEALTH ───────────────────────────────────────
  ◇ Settings                ✓ API Key ............................ Configured
  ? Help                    ✓ Project Link ....................... 0a54cb09-452
                            X API Status ......................... Unauthorized
FOCUS MODULE                ✓ Git Repository ..................... master (dirty)
◆ SIDEBAR                   
[Tab] Toggle focus          NEXT BEST ACTION ───────────────────────────────────
                            ✓ All clear. Keep this cockpit open during review.

TUI Shortcuts

APPLYING AI FIXES

From terminal

Review diffs and apply fixes directly via CLI subcommands.

bash

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

From dashboard

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

Patch conflicts

If the source file changed since the fix was generated, the .patch file is saved to .claron-conflicts/ for manual review.