terminal-status

Claude Terminal Status

A Claude Code skill that dynamically updates your VS Code terminal tab title based on what Claude is doing.

Features

• Shows current task and action: Claude: Adding auth > Editing auth.py
• Star indicator when Claude is waiting for input: * Claude: Ready
• Tracks in-progress todos for context

Requirements

• Claude Code CLI
• VS Code with integrated terminal
• jq installed (brew install jq)

Installation

1. Clone to your Claude skills directory:

   git clone https://github.com/YOUR_USERNAME/claude-terminal-status.git ~/.claude/skills/terminal-status
   

2. Add hooks to ~/.claude/settings.json:

   {
     "hooks": {
       "SessionStart": [
         {
           "matcher": "startup|resume|clear|compact",
           "hooks": [
             {
               "type": "command",
               "command": "/Users/YOUR_USERNAME/.claude/skills/terminal-status/hooks/update-terminal-title.sh session"
             }
           ]
         }
       ],
       "PreToolUse": [
         {
           "matcher": "",
           "hooks": [
             {
               "type": "command",
               "command": "/Users/YOUR_USERNAME/.claude/skills/terminal-status/hooks/pre-hook-wrapper.sh",
               "timeout": 5
             }
           ]
         }
       ],
       "PostToolUse": [
         {
           "matcher": "",
           "hooks": [
             {
               "type": "command",
               "command": "/Users/YOUR_USERNAME/.claude/skills/terminal-status/hooks/update-terminal-title.sh post",
               "timeout": 5
             }
           ]
         }
       ]
     }
   }
   

3. Update VS Code setting (Cmd+Shift+P → "Preferences: Open User Settings (JSON)"):

   "terminal.integrated.tabs.title": "${sequence}"
   

4. Add alias to ~/.zshrc:

   alias claude='export TTY=$(tty) && command claude'
   

5. Reload: source ~/.zshrc

Usage

Just run claude in VS Code's integrated terminal. The tab title will update automatically.

How It Works

• SessionStart hook: Sets title to "Claude: Ready"
• PreToolUse hook: Shows current action (e.g., "Reading file.ts")
• PostToolUse hook: Adds star to indicate waiting for input
• TTY capture: The alias captures your terminal device before Claude starts its own pty