setup

/carbonlog:setup

Set up the CNaught Carbonlog plugin.

Instructions

Follow these steps in order:

Step 0: Check for existing setup

Run the setup check script to see if the plugin has already been set up:

npx -y bun ${CLAUDE_PLUGIN_ROOT}/src/scripts/carbonlog-setup-check.ts

This outputs JSON. If isSetup is true, the plugin has already been configured. Show the user their current configuration:

• When they first set up (installedAt)
• Whether sync is enabled and their team name
• Their project ID
• Whether the statusline is active

Then ask the user what they'd like to do:

• Reconfigure — walk through the full setup again (continue to Step 1)
• Nothing — everything is already set up, exit

If isSetup is false, this is a first-time setup — proceed to Step 1.

Step 1: Ask about historical sessions

Ask the user whether they want to:

• Start fresh — only track new sessions going forward
• Backfill — process all previous Claude Code sessions from transcript files on disk

Step 2: Ask for team name

Ask the user for their team name (free text, required). Tell them that this should usually be something like their company or organization name. This is used to group users into teams and identify their sessions. They cannot skip this. DO NOT use the AskUserQuestion tool here since they have to provide an input.

Step 3: Ask about anonymous tracking

Ask the user whether they want to enable anonymous carbon tracking with CNaught:

• Enable — session metrics (token counts, CO₂, energy, project ID) will be synced to CNaught's API. No code, conversations, or personal information is shared. (default)
• Disable — all data stays local only

Step 4: Run the setup script

Build the command with the appropriate flags based on the user's choices:

• Always include --team "Their Team"
• Add --backfill if the user chose to backfill historical sessions
• Add --disable-sync if the user chose to disable anonymous tracking