Onboard

SessionStartsessionEnabled by default

Fires once after install to welcome the user and surface the tonone-onboard skill, then stays silent forever after.

Why use this

A new plugin with 23 agents and 100+ skills is easy to install and then forget. This hook guarantees every user sees the entry point to the tour exactly once, without ever nagging them again.

Lifecycle

Where in the Claude Code session this hook fires.

SessionStart

→

PreToolUse

→

PostToolUse

→

Stop

→

Notification

Session Start

Fires once when a Claude Code session opens.

How it works

On first session start after install, writes a marker file to ~/.config/tonone/onboarded and prints a welcome banner pointing to the /tonone-onboard tour. On every subsequent session start it exits silently. Never blocks the session on error.

settings.json

What the hook configuration looks like in ~/.claude/settings.json after install.

~/.claude/settings.json

{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "node ~/.claude/plugins/tonone-ai/tonone/tonone-onboard.js"
          }
        ]
      }
    ]
  }
}