cctop-setup

cctop-setup is a skill for Claude Code, Codex from st0012/cctop. It costs 31 tokens per session (365 once invoked), scanned A, original, MIT.

An installation guide for cctop, a macOS menu-bar app that monitors coding-agent sessions.

In plain words
What is it for?
Checking whether cctop is installed, installing it, verifying the hook, and launching the monitoring app.
Why use it?
It helps restore session monitoring when the cctop command or hook is missing.

Skill for Claude CodeCodex

Part of the cctop plugin — 1 skill, 11 hooks shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/st0012/cctop/cctop-setup
Any agent
npx skills add st0012/cctop --skill cctop-setup
Clone the repo
git clone --depth 1 https://github.com/st0012/cctop

Made for: Claude Code, Codex.

Or install cctop, the plugin that ships this one along with the rest of its 1 skill, 11 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for cctop-setup

README.md
[![agentmods](https://agentmods.dev/badge/skills/st0012/cctop/cctop-setup.svg)](https://agentmods.dev/skills/st0012/cctop/cctop-setup)
Your own site
<a href="https://agentmods.dev/skills/st0012/cctop/cctop-setup"><img src="https://agentmods.dev/badge/skills/st0012/cctop/cctop-setup.svg" alt="Measured on agentmods" height="20"></a>
Per session 31 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 365 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00031 $0.00365
Opus 5 $0.00015 $0.00182
Sonnet 5 $0.00006 $0.00073
Haiku 4.5 $0.00003 $0.00036

Measured 6d ago against content hash 891050c0ac6d, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

cctop-setup scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/cctop/skills/cctop-setup/SKILL.md · 54 lines

What it actually says

cctop Setup Skill

Helps install the cctop app required for session monitoring.

When to Use

Run installation guidance when:

  • Hook fails with "cctop-hook not found"
  • User asks to set up cctop monitoring
  • Session tracking is not working

Installation

Step 1: Check if cctop.app is installed

ls /Applications/cctop.app/Contents/MacOS/cctop-hook 2>/dev/null || ls ~/Applications/cctop.app/Contents/MacOS/cctop-hook 2>/dev/null

If not found, the user needs to install cctop.app.

Step 2: Install cctop

Option A: Homebrew (recommended)

brew install --cask st0012/cctop/cctop

Option B: Download from GitHub Download the latest release from https://github.com/st0012/cctop/releases/latest and move cctop.app to /Applications/.

Step 3: Verify installation

/Applications/cctop.app/Contents/MacOS/cctop-hook --version

Step 4: Launch the app

open /Applications/cctop.app

After Installation

The hooks registered by this plugin will now work. Session data will be written to ~/.cctop/sessions/ when Claude Code or Claude Desktop hooks fire.

The menubar app will show session status in the macOS menu bar.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago First seen · 54 lines · 31 tokens per session scan A 891050c0ac6d

Subscribe to this mod's changes

cctop-setup is a skill published in the GitHub repository st0012/cctop (148 stars, last pushed 4d ago), licensed MIT. It adds 31 tokens to every session and 365 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

todos

This chat has a shared, live TODO plan — your tasks for the conversation, which the user also edits. Read this skill and reach for the todo tools whenever a request takes more than a couple of steps. It covers the plan model (group = task, items = its steps; loose items are the user's lane), how to work it: propose…

JetBrains/thinkrail · 127 tokens

pdlc-settings

交互式配置 PDLC(当前:状态栏 statusline 的启用/停用/展示项).

kanfu-panda/pdlc-skills · 28 tokens

dropover

Comprehensive operational skill specification for Anthropic Claude to automate, script, troubleshoot, and optimize Dropover, floating NSPanel shelf windows, CGEventTap shake gestures, and URL scheme integrations.

alivirgo/Major-AI-Skills · 41 tokens

sq-do-not-disturb

Do Not Disturb mode — pause quests for 2 hours. Use this when the user says 'stop showing me stuff', 'too many quests', 'quest fatigue', 'these are annoying', 'I'm getting too many notifications', 'not now', 'leave me alone', 'stop interrupting', 'I need a break', 'pause quests for a bit', 'quiet mode', 'mute…

trySideQuest-ai/sidequest · 94 tokens

sq-settings

Enable or disable SideQuest quests. Use this when the user says 'turn off quests', 'stop sidequest', 'enable sidequest', 'disable the plugin', 'turn off the plugin', 'disable quests', 'stop showing quests', 'I want to pause quests permanently', 'disable the sidequest plugin', or similar requests to permanently toggle…

trySideQuest-ai/sidequest · 77 tokens

cmd-switch

切換到其他專案。.

maxyeh0817/Forge · 10 tokens