Quick start

This is a five-minute tour. By the end you’ll have CLACOROO running, your Claude Code configuration visible, and a first plugin enabled or installed — without typing a single CLI command.

If you haven’t installed the app yet, start with Installation.

1 · First launch

Open CLACOROO from your Applications (macOS), Start menu (Windows), or app launcher (Linux). The window opens on the Dashboard, and the onboarding tour starts automatically.

The tour is a series of small bubbles that point to the parts of the UI you’ll use the most — sidebar, dashboard, plugins, MCP servers, hooks, the built-in terminal, and the settings page. Click Next to step through it, or Skip to dismiss it. You can replay it any time from Settings · Onboarding or from the command palette.

Tip. If your operating system is set to Italian, the app starts in Italian. You can change it from Settings · Language, and the change is live — no restart needed.

2 · Take stock of your setup

The Dashboard gives you the big picture at a glance:

• Context estimate — how big the prompt context is right now, with a colored bar
• Claude quote — your current Session / Weekly / Weekly Sonnet usage, when each one resets
• Statistics — a row of KPI cards: active plugins, disabled plugins, marketplaces, total skills, total agents, MCP servers connected, hooks, and so on
• Claude Code usage — sessions, messages, tokens, estimated API value, current streak, and your favorite model
• Plugins by weight — your active plugins ranked by context cost
• Recent activity — the latest actions you took, with success/failure indication

If the page looks empty, you probably haven’t installed any marketplaces or plugins yet. That’s the next step.

3 · Add a marketplace

A marketplace is the source from which plugins are installed (typically a Git repository). Without at least one marketplace, your Plugin section is empty.

1. In the sidebar, click Marketplaces
2. Click + Marketplace in the top-right
3. Paste a Git URL, a GitHub repo (user/repo), or a local path
4. Confirm — CLACOROO runs claude plugins marketplace add <source> for you

The marketplace appears as a card, with the list of plugins it offers. You can update or remove it later from the same card.

4 · Install your first plugin

From the Marketplaces section, click a marketplace card to expand it. You’ll see every plugin it bundles, each with an Install button.

1. Find a plugin that interests you
2. Click Install on its row
3. CLACOROO runs claude plugins install <plugin>@<marketplace> and shows a green toast on success
4. The plugin now appears in the Plugin manager

In the Plugin manager you can:

• Enable / Disable the plugin (toggle on the card)
• Update to the latest version when available
• Remove when you no longer need it
• Open in Finder to see its files on disk, or Open in VS Code to edit them

Every plugin can ship its own skills, agents, MCP servers and hooks. Each of these gets its own section in the sidebar and shows up there automatically.

5 · Move around the app

A few shortcuts that pay off immediately:

• Cmd / Ctrl + K — open the command palette to jump to any section, reload data, export a snapshot, replay the tour, or check for updates
• Cmd / Ctrl + 1..9 — jump to a specific section (1 = Dashboard, 2 = Marketplaces, 3 = Plugins, …)
• Cmd / Ctrl + R — reload data from disk (useful if you ran a claude command in another window)
• Terminal button (top-right) — open the built-in terminal with multi-tab support. Useful for claude commands CLACOROO doesn’t wrap yet (rare) or to log in to your account interactively.

You’re set

That’s the loop: add a marketplace, install plugins, manage them — and watch skills, agents, MCP servers and hooks light up the rest of the sidebar.

From here:

• Concepts — the mental model behind plugin, skill, agent, MCP server and hook, and how they relate
• Plugins — the deep tour of the Plugin section
• MCP servers — adding HTTP, SSE, or stdio servers
• Claude account — connecting your claude.ai login or an Anthropic API key