HeyDev
Hey dev, your AI is waiting for you.
A VS Code extension that shows real-time status indicators for AI CLI sessions (like Claude Code) in your terminal tabs, with smart notifications that bring you back when the AI is waiting for input.
The Problem
When running multiple AI CLI sessions in VS Code, you constantly switch between terminals to check if the agent is done working or waiting for your input. There's no visual indicator in the terminal tab, and no way to know which session needs attention.
The Solution
HeyDev adds live status indicators to your terminal tabs and sends smart VS Code notifications when your AI agent has been waiting for you.
Features
Terminal Tab Status
Each AI terminal tab shows its current state with a unique session tag:
- ⚡ Claude [a1b2] - Working — The AI agent is actively using tools
- 👀 Claude [a1b2] - Waiting — The AI agent is waiting for your input
The 4-character tag (a1b2) uniquely identifies each session, so you can tell multiple terminals apart at a glance.
Smart Notifications
When the AI agent has been waiting for your input, a VS Code notification appears with context about what it's asking:
- Focus Terminal — Instantly switches to the correct terminal
- Quick Reply — Opens an input box to send a response (e.g., "yes", "no", "continue") without switching terminals
Notifications are smart:
- Show a snippet of the AI's last message so you know what it's asking
- Only fire after a configurable delay (default: 60 seconds)
- Cancelled if the AI starts working again before the delay
- Cancelled if you manually switch to the terminal
- Suppressed if the terminal is already focused
Configurable Settings
Customize emojis, notification timing, and more:
Status Bar
The VS Code status bar shows the state of the currently focused AI terminal session.
- Claude Code — Fully supported today via hooks
- Codex, Copilot, Aider — Planned for future releases
Installation
Quick Setup (Recommended)
- Install HeyDev from the VS Code Marketplace
- Install jq if you don't have it:
brew install jq (macOS) or download
- Open VS Code →
Cmd+Shift+P → "HeyDev: Setup Claude Code Integration"
- Restart your Claude Code sessions
That's it. The setup command automatically:
- Creates the hook script
- Configures Claude Code hooks (preserving your existing hooks)
- Disables Claude's built-in title management
- Creates the state directory
Uninstalling
Important: Run this before uninstalling the extension from VS Code.
Cmd+Shift+P → "HeyDev: Remove Hooks from Claude Code"- This removes all hooks, env vars, scripts, and offers to revert VS Code settings
- Then uninstall the extension from the Extensions panel
VS Code doesn't support auto-cleanup on extension uninstall, so step 1 is required to remove the Claude Code hooks cleanly.
Building from Source
git clone https://github.com/SalilMonga/HeyDev.git
cd HeyDev
npm install
npm run compile
npx @vscode/vsce package --allow-missing-repository
code --install-extension heydev-0.1.0.vsix
Settings
Configure via VS Code Settings (Cmd+,) → search "HeyDev":
| Setting |
Default |
Description |
heydev.showNotifications |
true |
Enable/disable VS Code notifications |
heydev.notificationDelaySeconds |
60 |
Seconds to wait before notifying (0 = immediate) |
heydev.workingEmoji |
⚡ |
Emoji for the "working" state in terminal tabs |
heydev.waitingEmoji |
👀 |
Emoji for the "waiting" state in terminal tabs |
heydev.stateDirectory |
(auto) |
Override state file directory |
Emoji changes sync automatically to the hook script — no manual editing needed.
How It Works
AI CLI (e.g. Claude Code)
↓ (hooks fire on state changes)
Hook Script (~/.claude/scripts/claude-hook-state.sh)
↓ writes state file ↓ sets terminal title
~/.claude/terminal-status/ Terminal tab: ⚡ Claude [a1b2] - Working
↓ (fs.watch)
VS Code Extension (HeyDev)
↓ maps session → terminal via PID
↓ sends notifications
VS Code notification: "[a1b2] has been waiting for 1 minute"
→ [Focus Terminal] [Quick Reply]
- Hooks fire on AI CLI events (tool use, stop, user prompt)
- Hook script writes a JSON state file and sets the terminal title
- HeyDev extension watches the state directory for changes
- PID matching maps each state file to the correct VS Code terminal
- Notifications appear after the configured delay with actions to focus or quick-reply
Compatibility
- VS Code 1.85+
- macOS (tested), Linux (should work), Windows (untested)
- Claude Code CLI with hooks support
- Terminal: Works in VS Code's integrated terminal
License
MIT
