The Eddie blog
Guides for running AI coding agents.
Copy-paste setups for Claude Code, Codex and the other agents: notifications, hooks, usage limits and keeping track of every session. Every config here is checked against the official docs.
Claude Code notifications
Know the moment an agent finishes or needs you, on macOS, Linux, Windows or your phone.
How to Get Notified When Claude Code Finishes (Mac, Linux, Windows)
Get a desktop notification or a sound when Claude Code finishes or needs permission. Copy-paste Stop and Notification hooks for macOS, Linux and Windows.
Claude Code Notification When Waiting for Input: Never Miss a Permission Prompt
Get alerted when Claude Code is waiting for your input or permission. How permission_prompt, idle_prompt and PermissionRequest differ, with copy-paste hooks.
Play a Sound When Claude Code Is Done (macOS, Linux, Windows)
Make Claude Code play a notification sound when it's done or needs permission. Copy-paste Stop hooks with afplay, paplay and PowerShell, plus a terminal bell.
Claude Code Notification Hook Not Working? 9 Fixes That Cover Almost Every Case
Claude Code notification hook not firing? Nine fixes, from the macOS Script Editor permission and invalid JSON to matcher typos, timing, trust and PATH.
Claude Code Notifications on Windows: Toast, Sound and Terminal Bell
Get Claude Code notifications on Windows: a toast, a sound or a taskbar flash when Claude finishes or needs permission. Copy-paste hooks for PowerShell and WSL.
Claude Code Notifications on Linux: notify-send, Sounds, GNOME and KDE
Get a Claude Code notification on Linux when Claude finishes or needs permission: notify-send hooks, sounds with paplay or pw-play, and fixes for SSH and tmux.
Get Claude Code Notifications on Your Phone
Get a Claude Code notification on your phone when it finishes or needs permission: built-in push through Remote Control, or a hook with ntfy, Pushover or Telegram.
Codex CLI Notifications: How to Know When Codex Is Done
Get a Codex CLI notification when Codex is done or needs approval: the built-in tui.notifications, the notify script, and Stop hooks for macOS, Linux and Windows.
Hooks and permissions
How Claude Code hooks and permission modes work, with configs you can paste.
Claude Code Hooks Explained: Every Event, With Examples
What Claude Code hooks are, where they go in settings.json, every hook event with its matcher and whether it can block, and six examples you can copy.
12 Useful Claude Code Hooks (Copy-Paste Examples)
12 Claude Code hooks examples to copy: block risky commands, guard pushes to main, lint after edits, catch secrets in prompts and get alerts on API errors.
How to Debug Claude Code Hooks: Find Out Why One Won't Fire
How to debug Claude Code hooks: check /hooks, fix the matcher, read the --debug-file log, replay real input by hand, and get exit codes and JSON output right.
Claude Code Hooks vs Skills: What's the Difference?
Claude Code hooks vs skills: hooks run your code on every matching event, skills are instructions Claude applies when relevant. When to use each, with examples.
Claude Code Permission Modes Explained (and When Skipping Is Safe)
All six Claude Code permission modes compared: Manual, acceptEdits, plan, auto, dontAsk and bypassPermissions, how to switch, and when skipping is safe.
Usage, limits and cost
What Claude Code costs, how its limits reset, and how to read your usage.
How Much Does Claude Code Cost Per Month? Pro vs Max vs API (2026)
Claude Code cost per month on Pro, Max 5x, Max 20x, Team and the API, with per-token prices, what drives your bill and how to check your spend.
Claude Code's 5-Hour Limit Explained: How It Works and When It Resets
How the Claude Code 5-hour limit works on Pro and Max, when it resets, how it relates to the weekly limit, and what to do when you hit it.
How to Check Your Claude Code Token Usage (and Plan Limits)
How to check Claude Code token usage: /usage, /context, the status line, local session logs, the Console and usage tools, and why their numbers differ.
"API Value" vs What You Pay: Reading Claude Code Cost on a Subscription
How Claude Code turns tokens into a dollar figure, the cost per token behind it, and why that API value isn't your bill on Pro or Max.
12 Ways to Cut Claude Code Token Usage
Twelve Claude Code tips to reduce token usage: clearing context, picking models and effort, trimming CLAUDE.md and MCP, filtering output and keeping the cache warm.
Claude Code Status Line: Setup and 8 Statusline Examples
Set up the Claude Code status line in two minutes, see every field it receives, and copy 8 statusline examples for context, cost, git and plan limits.
Running agents day to day
Parallel sessions, background work, stuck agents and the processes they leave behind.
How to Run Multiple Claude Code Sessions in Parallel (and Keep Track)
Run several Claude Code sessions at once with git worktrees, background sessions and agent view, then name them and get alerted when one needs you.
How to Run Claude Code in the Background
Run Claude Code in the background: Ctrl+B for long commands, /bg and claude --bg for whole sessions, claude -p for scripts, and how to check and stop tasks.
Claude Code Stuck? What Each State Means and What to Do
Claude Code stuck on thinking, compacting or waiting for API response? What each state means, how to tell waiting from frozen, and how to recover safely.
Find and Kill the Dev Servers Your AI Agent Left Running
Claude Code zombie processes are usually orphaned dev servers holding a port. Find them with lsof and ps, stop them safely, and keep them from coming back.
Claude Code vs Codex vs Gemini CLI: Pricing, Features and Which to Pick
Claude Code vs Codex vs Gemini CLI compared from their official docs: pricing and free tiers, open source, sandboxing, config files, hooks and limits.
The notch and the Mac
Getting real work out of the MacBook notch and the menu bar.
Dynamic Island on a Mac: What Exists, and How to Get One
Macs have no Dynamic Island, but macOS Tahoe shows iPhone Live Activities in the menu bar and notch apps fill the gap. Here's what each option does.
The Best Mac Notch Apps for Developers in 2026
The best Mac notch apps for developers, compared: agent status, permission alerts, music, files, notes and free options, checked on each app's own site.
Watch Your AI Agents From the MacBook Notch
See what every Claude Code, Codex and Gemini CLI session is doing from your Mac's notch or menu bar: status, permission prompts and usage, compared.
Clipboard History on Mac: The Built-In Options and the Best Clipboard Managers
How to see clipboard history on a Mac with Spotlight in macOS Tahoe, the other built-in clipboard tools, and when a clipboard manager app is worth adding.
Focus and health
Breaks, pomodoros and stretches for long sessions with AI agents.
Pomodoro for Developers Who Work With AI Agents
A developer pomodoro routine for the age of coding agents: 25-minute focus blocks, agent check-ins on the breaks, and only real blockers allowed to interrupt.
Desk Stretches and the 20-20-20 Rule for Programmers
A coding break reminder built on official advice: the 20-20-20 rule for eye strain, hourly movement breaks, five NHS desk stretches and simple reminder setups.