ClaudeSuperPower
SubmitLog in
S

SessionStart (startup)

Hook
0Other

Fires on

SessionStartmatchingstartup

Once, as a session begins — before you type anything.

Where this sits in a session

  1. Session start→
  2. Prompt submitted→
  3. Prompt expansion→
  4. Before tool use→
  5. After tool use→
  6. Notification→
  7. Before compaction→
  8. Subagent finished→
  9. Turn finished→
  10. Session end

Observes only — Emits messages or context. It never returns a permission decision.

What it runs

Executed automatically when the event fires — no prompt, no confirmation.

command
node "${CLAUDE_PLUGIN_ROOT}/hooks/check-cc-fleet.js"

Install it yourself

Paste into .claude/settings.json to run this hook without installing the whole plugin. Adjust the paths to point at your own copy of the scripts.

settings.json
{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/check-cc-fleet.js\""
          }
        ],
        "matcher": "startup"
      }
    ]
  }
}

Source

Read this before installing — it runs on your machine with your permissions.

#!/usr/bin/env node
// cc-fleet plugin · SessionStart binary check.
//
// This plugin ships ONLY the skill (+ this hook). The
// native `cc-fleet` Go binary is installed SEPARATELY onto PATH — a plugin
// can't compile or reliably ship a native binary (no install-time hook; the
// plugin root path is ephemeral and would break the apiKeyHelper pin baked
// into provider profiles).
//
// If the binary is missing, the skill can still route a request but every CLI
// call it makes will fail, so we nudge once at session start.
//
// Contract: SessionStart hooks must NEVER block the session — we always exit 0.
//   - binary present  -> print nothing (no context noise)
//   - binary missing  -> one-line install hint on stdout (Claude Code folds it
//                        into the session context and shows the user)
//
// Node ships with Claude Code, so this runs on every platform; on win32 the
// PATH probe honors PATHEXT (cc-fleet.exe / .cmd / …).
"use strict";

const fs = require("fs");
const path = require("path");

function onPath() {
  const dirs = (process.env.PATH || "").split(path.delimiter).filter(Boolean);
  const win = process.platform === "win32";
  // On Windows a bare name resolves through PATHEXT; elsewhere it's the file
  // itself (an executable bit is not required for "is it findable").
  const exts = win
    ? (process.env.PATHEXT || ".COM;.EXE;.BAT;.CMD").split(";").filter(Boolean)
    : [""];
  for (const dir of dirs) {
    for (const ext of exts) {
      const candidate = path.join(dir, "cc-fleet" + ext);
      try {
        if (fs.statSync(candidate).isFile()) return true;
      } catch {
        // not here — keep looking
      }
    }
  }
  return false;
}

if (!onPath()) {
  console.log(
    "cc-fleet binary not found on PATH — the cc-fleet skills need it to spawn provider teammates/subagents. Install: go install github.com/ethanhq/cc-fleet/cmd/cc-fleet@latest  (or grab a release / see https://github.com/ethanhq/cc-fleet#install)."
  );
}
process.exit(0);

Shipped by 1 plugin

Installing any of these installs this hook.

cc-fleet198

Reviews

Log in to leave a review.

No reviews yet — be the first.

Explore related

Other things in this space — across every part of the ecosystem, not just hooks.