Blog
Practical guides for people who use Claude Code all day.
October 16, 2026 · 7 min read
The notchfit Command Line: Drive Your Workout, Read Status as JSON, Validate Plans and Test the Notch Without Leaving the Terminal
NotchFit installs a notchfit CLI with its Claude Code and Codex integrations. Every command explained (start, stop, done, skip, now, pause, status, validate, reload, catalog, simulate, doctor), five workflows it makes possible, and what it deliberately does not do.
October 16, 2026 · 8 min read
How to Make MCP Servers Not Take Up as Much Context in Claude Code: Tool Search, alwaysLoad, Scopes and Output Caps
Every MCP tool definition used to be sent to Claude on every turn. Tool search now defers them by default; here is how to check it is on, when it is silently off, and the five other levers (alwaysLoad, /mcp disable, scopes, MAX_MCP_OUTPUT_TOKENS, shorter descriptions) that keep MCP from eating your context window.
October 13, 2026 · 7 min read
What a MacBook Notch App Can Actually Do: The Five Kinds of Notch Utility, Their Trade-offs, and Where NotchFit Fits
Every notch app for macOS falls into one of five categories: media controls, Dynamic Island clones, file shelves, focus timers and oddities. What each does, what it costs you, and why NotchFit, built for Claude Code and Codex users, is a category of one.
October 13, 2026 · 8 min read
Is It Possible to Get a Notification When Claude Code or Codex Hits a Reset? Yes for Claude Code: the quota_auto_resume Hooks, Explained
Claude Code v2.1.234+ waits for a usage limit to reset and continues your task on its own; three Notification hook matchers (quota_auto_resume_fired, stale, disabled) let you get a macOS alert the moment it does. Exact settings.json, plus the timer method for Codex.
October 10, 2026 · 7 min read
What to Do While Claude Code or Codex Works: A Simple Protocol for the Two-to-Twenty-Minute Gap in Every Agent Run
A coding agent hands you back minutes you cannot use for anything else. How to estimate the gap, fit one guided set into it with NotchFit, decide whether to leave the desk, and when not to work out during a run at all.
October 10, 2026 · 8 min read
Why Codex CLI Asks for Permission Every Time, and How to Tune the Sandbox and Approval Policy Without Going Full Access
Codex CLI keeps asking for approval because an action crossed the sandbox. The sandbox modes, approval_policy values (on-request, never, granular), the /permissions presets, config.toml keys and flags, and five ways to get fewer prompts safely.
October 9, 2026 · 7 min read
What a Notch App Can See: NotchFit's Local-First Design, What the Claude Code and Codex Hooks Send, and What Stays on Your Mac
NotchFit watches your Claude Code and Codex runs from the MacBook notch. What its hooks actually send, why everything stays on localhost, what touches the network and why, how to verify it yourself, and the honest limits of local-first.
October 9, 2026 · 9 min read
How to Run a Claude Code Session in the Background: /background, claude --bg, Agent View, and Getting Back to It
Run Claude Code in the background without losing the session: the ← key and /bg, claude --bg from the shell, agent view, the one-hour stop rule, worktree isolation, permissions, notifications and the settings that control it.
October 8, 2026 · 6 min read
NotchFit on a Mac Without a Notch: How Pill Mode Works on Mac mini, iMac, Mac Studio and a MacBook With the Lid Closed
NotchFit runs on every Mac with macOS 14 or later. On Macs without a notch, and on notched MacBooks driving an external display with the lid closed, it shows a top-centre pill that expands into the same workout and agent panel. What changes, what does not, and the honest trade-offs.
October 8, 2026 · 9 min read
How to Resume a Claude Code Session: --continue vs --resume, Naming Sessions, the Session Picker, Branching, and What Comes Back
Every way to get back into a Claude Code conversation: claude --continue, claude --resume by name or ID, the session picker shortcuts, /resume and /rename, --fork-session and /branch, what a resumed session restores, the resume-from-summary dialog, and where transcripts live.
October 6, 2026 · 7 min read
Why NotchFit's Done and Permission Alerts Wait Until Your Set Ends, When That Costs You, and How to Turn the Workout Off
NotchFit deliberately delays Claude Code and Codex done and permission alerts until the current set finishes. Why that is the right trade for a movement habit, how manual Start set and rest timers fit in, the cases where you want the alert now, and the Hide workout toggle.
October 6, 2026 · 7 min read
Claude Code Spinner Verbs Explained: What “Pondering” and “Brewing” Mean, How to Change Them, and Why You Should Stop Watching the Spinner
What the random verbs next to Claude Code's spinner mean (nothing), how to replace them with spinnerVerbs, how to hide or add spinner tips with spinnerTipsEnabled and spinnerTipsOverride, the thinking toggle, and why a notification beats staring at the spinner.
October 5, 2026 · 8 min read
/notchfit:plan Explained: How Claude Code or Codex Writes a Weekly Workout Plan the Notch Can Actually Run
What /notchfit:plan (Claude Code) and $notchfit-plan (Codex) ask, how the plan is built from the 239 exercises NotchFit can animate, where it is saved, how to get a better plan out of the interview, and where an AI-written plan should not be trusted.
October 5, 2026 · 10 min read
Claude Code MCP Servers Explained: Adding Servers, Choosing a Scope, Handling Secrets, and Why Long Tool Calls Go to the Background
A practical guide to MCP in Claude Code as of October 2026: claude mcp add for HTTP, SSE and stdio, local vs project vs user scope, .mcp.json with environment variables and OAuth, the /mcp status words, timeouts, the 25k-token output cap, and the two-minute auto-background rule.
October 4, 2026 · 8 min read
Building a Movement Habit at a Desk: Use the Agent Run as the Cue, One Set as the Unit, and Streaks Carefully
Why desk workout habits fail and how to make one stick: an event-based cue (your agent going quiet), one set as the unit, what the habit research actually says, streaks vs heatmaps, a four-week ramp, and how NotchFit implements each piece.
October 4, 2026 · 10 min read
Claude Code Headless Mode: Running claude -p in Scripts and CI, and the Three Signals That It Finished
A practical guide to claude -p in 2026: --bare, --allowedTools and permission modes for unattended runs, json and stream-json output, --json-schema, chaining with --continue and --resume, exit codes, and how to know a headless run is done.
October 3, 2026 · 8 min read
NotchFit vs Mac Break Reminder Apps: A Clock or a Signal From Your Coding Agent?
How NotchFit compares with Time Out, Stretchly, BreakTimer and LookAway on a Mac: what triggers the break, what happens mid-flow, exercise libraries, price, privacy, and which to run for your kind of day.
October 3, 2026 · 9 min read
Claude Mods Explained: What the New Plugin Layer Can Do, and How to Turn On 'You Should Know'
Claude Code 2.1.287 added Claude Mods. What a mod is versus hooks and skills, what it can draw and change, the smallest useful mod, how to enable the built-in 'You should know' side agent, and what it means for notifications.
October 2, 2026 · 7 min read
Setting Up NotchFit With OpenAI Codex CLI: Hooks, $notchfit-plan, and the Daily Flow
How to connect NotchFit to OpenAI Codex CLI on a Mac: one-click skills and hooks, trusting them via /hooks, letting Codex write your plan, and what the notch shows while Codex works.
October 2, 2026 · 8 min read
Claude Code /loop: Poll a Deploy, Babysit a PR, and Get Told When It's Done
How Claude Code's /loop skill and scheduled tasks work: fixed vs self-paced intervals, loop.md, jitter, the 7-day expiry, what survives a restart, and pairing a loop with a done notification.
October 1, 2026 · 7 min read
Claude Remote Control: How It Works, Turning It Off, and Auto Mode
How Claude Code Remote Control works, four ways to turn it off, and how to use it with auto mode when the app won't let you select Auto. Verified answers.
September 30, 2026 · 8 min read
Claude Code Checkpoints and /rewind
Claude Code checkpoints before every edit, and /rewind restores code, conversation, or both. What it does that git cannot, the limits, and the workflow that uses it properly.
September 25, 2026 · 7 min read
Claude Code Notch Notifications on Mac: See When Claude Is Done Without Watching the Terminal
Get Claude Code notifications on your Mac's notch: see when Claude is working, done, or needs permission without watching the terminal. Hooks, banners and notch options compared.
September 25, 2026 · 7 min read
Exercise While Coding: Turn Claude Code Wait Time Into Micro-Workouts
How to use the minutes Claude Code or Codex spends working for exercise snacks and movement breaks — a simple system for AI coding breaks that doesn't hurt your focus.
September 25, 2026 · 7 min read
Desk Exercises for Programmers: 15 Moves to Do While Your AI Agent Codes
15 desk exercises for programmers and developers you can do in the minutes Claude Code or Codex is working: neck, shoulders, wrists, back, hips and legs — no gym, no sweat.
September 23, 2026 · 9 min read
Claude Code Notifications on WSL and Windows
notify-send does nothing, the terminal bell is silent, and no toast appears. Why Claude Code notifications break under WSL, and the three setups that actually work.
September 22, 2026 · 10 min read
Claude Code Environment Variables: The Groups That Actually Matter
A practical map of Claude Code environment variables — background tasks, bash timeouts, thinking budgets, notifications and traffic — plus the precedence rule that breaks most configs.
September 21, 2026 · 7 min read
Cursor Alerts Explained: Every Alert Cursor Raises, and How to Control Them
Cursor alert, explained: completion sounds, attention notifications, approval prompts and editor diagnostics — which are reliable, which are not, and how to fix each.
September 21, 2026 · 8 min read
CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP Explained
Claude Code kills every background task at once on a memory-pressure event, even with RAM to spare. What the reaper is, why PSI triggers it, and when to disable it.
September 17, 2026 · 7 min read
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS Explained
The env var that turns off auto-backgrounding and Ctrl+B in Claude Code. What it changes, the four cases where it is the right call, and what you give up.
September 15, 2026 · 7 min read
Claude Code Notifications Inside Your Editor's Terminal
Running Claude Code in VS Code, Cursor or a JetBrains terminal changes where notifications come from. The bell setting that is off by default, and which app owns the permission.
September 14, 2026 · 10 min read
Claude Code Notifications Not Working: A Diagnostic Checklist
Claude Code notifications silent? Four layers drop the signal: channel mismatch, terminal settings, OS permission, and firing where you are not looking.
September 13, 2026 · 8 min read
Codex vs Claude Code Notifications: How Each One Tells You It Is Done
Codex CLI fires one external notify event; Claude Code has hooks for several. A side-by-side of how each agent signals done vs blocked, and how to wire both.
September 12, 2026 · 8 min read
Claude Code Effort Levels: Why Your Setting Keeps Getting Ignored
low, medium, high, xhigh and ultracode — plus the exact resolution order Claude Code uses, the default-effort hold, and why maxEffortLevel can silently override you.
September 11, 2026 · 7 min read
Claude Code Notifications in tmux and Over SSH
Claude Code notifications stop working inside tmux and disappear entirely over SSH. Why the bell gets swallowed, how to fix tmux, and how to push alerts off a remote machine.
September 9, 2026 · 6 min read
preferredNotifChannel: Claude Code's Built-In Notification Setting
What Claude Code's preferredNotifChannel setting does, all seven values explained (auto, terminal_bell, iterm2, kitty, ghostty and more), and how to turn on notifications in any terminal.
September 8, 2026 · 7 min read
Claude Code Remote Control, Explained
How Claude Code Remote Control works: connect to a live local session from the Claude mobile app or browser, its limits, and pairing it with push notifications.
August 22, 2026 · 6 min read
Get Claude Code Notifications on Your Phone
How to get Claude Code notifications on your phone: free push alerts with ntfy, Pushover priority alerts, and a private Telegram bot - plus rules to avoid noise.
August 20, 2026 · 6 min read
Gemini CLI Notifications: How to Get a Sound or Alert When Gemini Finishes
How to get a notification when Gemini CLI finishes a task or waits for input — the experimental /settings sound, terminal bells, notify-sound and chime extensions, and a zero-config native macOS notifier.
August 19, 2026 · 6 min read
terminal-notifier + Claude Code: Native macOS Alerts When Your Agent Finishes
Set up terminal-notifier for native macOS alerts when Claude Code finishes or needs input — brew install, hooks config, osascript fallback, permission fixes.
August 18, 2026 · 6 min read
Codex Sound When Done: Make Codex CLI Play a Sound When It Finishes
How to make Codex CLI play a sound when it's done — the one-line afplay config, custom sounds, Linux and Windows equivalents, and a ding for waiting-on-input too.
August 17, 2026 · 6 min read
“Notifications Are Turned Off for Claude” — Here Is the Fix
Seeing “notifications are turned off for Claude, enable them in System Settings”? Step-by-step macOS fix for Claude and Claude Code alerts, plus Focus-mode gotchas.
August 16, 2026 · 6 min read
Get Notified the Moment Claude Code Is Waiting for Your Input
Claude Code notify when input needed: set up the Notification hook for permission prompts and idle waits, how it differs from Stop, and a zero-config option.
August 15, 2026 · 6 min read
Get a Ding the Moment Codex Needs Your Response
Codex ding when prompt response needed: enable tui.notifications for approval-requested alerts, why the notify hook stays silent, and Claude Code equivalents.
August 14, 2026 · 6 min read
Claude Code Notification Scripts: Copy-Paste Recipes for Every Platform
Working Claude Code finished notification scripts: hook configs that play a sound, show a banner, or ping your phone when Claude Code is done or needs input.
August 12, 2026 · 5 min read
Want to Be Notified When Claude Responds? How Claude Notifications Work on Web, Desktop, and Mobile
What the 'Want to be notified when Claude responds?' prompt does, how to enable Claude notifications on web, desktop and mobile, and what to use in the terminal.
August 11, 2026 · 6 min read
Claude Code Notifications: How to Get Notified When Claude Code Finishes or Needs Your Input
Set up Claude Code notifications: the terminal bell setting, Notification and Stop hooks with sounds and banners, phone push via ntfy, and a zero-config app.
August 10, 2026 · 6 min read
Cursor Notification When Done: Every Way to Get Notified When Cursor Finishes
How to get a Cursor notification when the agent is done — the built-in completion sound, system notifications, hooks, phone push, and a zero-config native app.
August 9, 2026 · 7 min read
Codex CLI Notifications: How to Get a Ding When Codex Is Done or Needs Input
How to set up Codex CLI notifications: the notify hook in config.toml, sounds with afplay, desktop banners, and zero-config alerts when Codex finishes or waits for input.
August 8, 2026 · 6 min read
Claude Code Background Tasks: Run Long Commands Without Blocking Your Session
How Claude Code background tasks work: Ctrl+B, background subagents, the /tasks view, output limits, auto-cleanup rules, and knowing when a run finishes.
August 8, 2026 · 7 min read
Skills and Plugins: How to Teach Claude Code Your Way of Working
What Claude Code skills and plugins actually are, how they differ, when to use each, and how to build your first skill in ten minutes - a practical guide for non-experts.
August 6, 2026 · 7 min read
Per-Subagent Model Selection: Route the Grunt Work Down, Keep the Judgment Up Top
Claude Code lets you assign a different model to every subagent. How to tier your agents so mechanical work runs cheap and fast while hard problems keep the strongest model.
August 5, 2026 · 6 min read
Claude Code Context Management: Treat the Context Window Like a Budget
Why Claude Code sessions degrade long before the context window is full — and how to budget CLAUDE.md, auto memory, MCP tools, and compaction deliberately.
August 4, 2026 · 7 min read
Claude Code Subagents: How to Delegate Work to Specialized Agents
What Claude Code subagents are, when to use them, and how to set up your own — custom agents with their own prompts, tools, and context that work while you don't watch.
August 3, 2026 · 7 min read
Claude Code Auto Mode: Fewer Permission Prompts Without Living Dangerously
What Claude Code's auto mode actually does, what it still blocks, how it differs from skipping permissions entirely — and how to set it up safely with deny rules.
August 2, 2026 · 7 min read
Claude Code Hooks: A Practical Guide to Automating Your Agent Workflow
A practical guide to Claude Code hooks — auto-format after edits, block risky commands, and get notified when Claude finishes, with working settings.json examples.
July 7, 2026 · 5 min read
A Claude Code Workflow That Doesn't Involve Watching the Terminal
Claude Code workflow tips and best practices: get a notification when Claude Code is done or waiting for input, and reclaim the minutes it runs instead of watching text scroll.
July 7, 2026 · 6 min read
Claude Code Multiple Sessions: How to Run Agents in Parallel Without Losing Track
How to run multiple Claude Code sessions, instances, and agents in parallel across terminals and projects — and keep track of all of them. A practical guide for heavy users.
July 7, 2026 · 8 min read
Claude Code Tips and Tricks: 12 Ways to Use Claude Code Effectively
Claude Code tips and tricks for beginners and heavy users alike — plan mode, briefing files, parallel sessions, notifications, and productivity tips for using Claude Code in the terminal effectively.