Cursor Agents Plugin

First Steps

Start the Project HUD and confirm selected-chat pill sync.

← Back Overview Requirements

1) Install Free (or Pro after Zebra)

Complete the Installation guide first. Pro users must also finish License + Download.

2) Start the Project HUD

Run hud:start (command palette or plugin command). The HUD window opens on Windows for Pro.

3) Confirm selected-chat sync

1. Open an Agents chat in Cursor.
2. Select that chat — the pill should update label and accent color.
3. Switch to another chat — pill should follow the selection.

4) Configure markers

• Free: open HUD Settings → pick an emoji marker.
• Pro: upload a custom logo or enable pattern marker.

5) Optional AKC accent sync

If AKC is installed in the same workspace, CCC can mirror workspace accent colors.

6) Activate for Pro

Download the Zebra build first, then paste your activation key in the HUD to unlock Pro settings.

Requirements

CCC is a Cursor Agents plugin (Agents → Customize) — not a VS Code extension, not a Marketplace .vsix, and not installed via VS Code’s Extensions view. The Project HUD host is Windows-first.

Columns

Requirement Version / Status

Show hidden rows

Requirement	Version / Status
Host	Cursor (Agents) — not VS Code
Package type	Cursor Agents plugin (no .vsix)
Free install	github.com/timejunky/r4it_ai_keep_clean_ccc_public
Pro download	Zebra (my-account) after purchase
HUD host	Windows (WinForms) — macOS/Linux on roadmap
License product_id	ccc