nickViduya

Agentnudge — Development skill for Claude Code

Development community

A macOS status light for your Claude Code and Codex sessions: see which agent needs you, jump to its terminal tab, start new sessions.

How to install Agentnudge

This entry records only its repository, not the path inside it, so there is no exact command to give. Open nickViduya/agentnudge and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Agentnudge does

A macOS status light for your Claude Code and Codex sessions: see which agent needs you, jump to its terminal tab, start new sessions.

Alternatives in Development

  • Tmux Claude Hatch — tmux plugin that runs Claude Code sessions in popups per project directory, with an fzf picker showing each se 381 ★
  • Tmux Claude Session Manager — Run many Claude Code sessions across your projects, each in its own tmux session — then list them, see which a 380 ★
  • Device Control Agent — You are an autonomous macOS agent with full control of this device via two CLI tools: - steer — GUI automation 250 ★

README

AgentNudge icon

AgentNudge

A small macOS indicator that tells you which of your Claude Code and Codex sessions need you,
without changing how you use your terminal.

The tray: 2 waiting, 2 running

You run several coding agents in several terminal tabs. Most of the time you don't need to watch them; you need to know when one has finished or is asking you something. AgentNudge sits in a corner of the screen (or around the notch) and tells you exactly that. Click it for the list, click a session to jump to its terminal tab.

Sessions that need you Sessions in progress, with subagents and a Codex thread

What it does

  • Tells you who needs you. A session that just finished its turn, or is waiting on a question, a plan approval or a permission prompt, lands in Needs you. The tray pulses until you've dealt with it. After 20 minutes without a reply (you can change this), it moves to Idle.
  • Shows what each session is doing: its title, Claude Code's latest recap or last reply, the project and branch, the permission mode (bypass, plan, auto, accept edits, ask), how much of the context window is used, and the subagents still running.
  • Jumps to the exact tab. In Ghostty, clicking a session focuses the very tab or split it runs in, found through the session's own terminal. Other terminals (Terminal, iTerm2, Warp, kitty, the VS Code terminal) are brought to the front.
  • Starts new sessions. Pick a workspace and run Claude, a session on a new branch, Codex, or a plain shell in a new Ghostty tab. A branch name on your clipboard is filled in for you.
  • Shows your plan usage: the 5-hour