Setup Status Line for Session Topics

Configure ccstatusline to show session topics as a second line.

Instructions

Step 1: Check ccstatusline config

Read ~/.config/ccstatusline/settings.json to see current configuration.

Step 2: Add custom-command widget

Add a second line with a custom-command widget pointing to the plugin's topic-display script:

{
  "id": "session-topic",
  "type": "custom-command",
  "rawValue": true,
  "commandPath": "~/.claude/plugins/cache/claude-session-topics-marketplace/claude-session-topics/*/scripts/topic-display",
  "color": "cyan"
}

The widget goes in the lines array as a new line (array of widgets).

Step 3: Example configuration

A typical ccstatusline config with topics looks like:

{
  "version": 3,
  "lines": [
    [
      {"type": "context-percentage", "color": "brightRed", "rawValue": true},
      {"type": "current-working-dir", "color": "brightBlue", "rawValue": true},
      {"type": "git-branch", "color": "green", "rawValue": true}
    ],
    [
      {
        "id": "session-topic",
        "type": "custom-command",
        "rawValue": true,
        "commandPath": "~/.claude/plugins/cache/claude-session-topics-marketplace/claude-session-topics/*/scripts/topic-display",
        "color": "cyan"
      }
    ]
  ]
}

Step 4: Verify setup

After making changes, verify everything is working by running the topic-display script:

~/.claude/plugins/cache/claude-session-topics-marketplace/claude-session-topics/*/scripts/topic-display "$CLAUDE_SESSION_ID"

This should output something like New session: gathering context for new sessions, or the actual topic if one has been generated.

Tell the user: "Setup complete. Your status line will show 'New session: gathering context' initially. After a few messages, it will update with an AI-generated topic summarizing your conversation. Restart Claude Code for changes to take effect."

Alternative: Use ccstatusline TUI

Users can also run npx ccstatusline@latest to open the interactive configuration UI and add a custom command widget there.

Troubleshooting

Enable debug logging:

export CLAUDE_TOPIC_DEBUG=1