Claron
    DEV
    Terminal-first

    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 sk-bd-<your-api-key>
      ✓ Authenticated as dev@example.com

    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 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
    ██████╗██╗      █████╗ ██████╗  ██████╗ ███╗   ██╗
    ██╔════╝██║     ██╔══██╗██╔══██╗██╔═══██╗████╗  ██║
    ██║     ██║     ███████║██████╔╝██║   ██║██╔██╗ ██║
    ██║     ██║     ██╔══██║██╔══██╗██║   ██║██║╚██╗██║
    ╚██████╗███████╗██║  ██║██║  ██║╚██████╔╝██║ ╚████║
     ╚═════╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝╚═╝  ╚═══╝
    ────────────────────────────────────────────────────────────────────────────────
    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.