Claude CodeSoftwareInfra & DevOpsAI score · 68/100AI-assisted edit · no obvious prompt-injection riskX

Claude Code Terminal Mod: Deploy Progress Bar + Mac Notifications

Deploy script writes JSON state per stage → Claude Code-generated terminal mod reads and renders progress bar → Mac notification on done or failed

ExperiencedStepsTip
Who
Developers with deploy scripts who want real-time terminal progress and completion/failure notifications
You get
Progress bar above the terminal prompt, Mac notification naming the step when done or failed
You need
Claude Code

Constraints

Requires: terminal with Claude Code installed, modifiable deploy script, macOS (for notifications). The script must write {step, total, label, state} to a JSON file at an agreed path per stage; the mod polls that file every 2s and draws the bar; failed steps are caught by a trap and shown in red; completion or failure triggers a Mac notification.

What they did

Fuat Kerkinni used Claude Code to build a terminal mod. His deploy script writes {step, total, label, state} to a JSON file at each stage; the mod checks that file every 2 seconds and draws a progress bar above the prompt. A failed step is caught by a trap and shown in red; completion or failure triggers a Mac notification naming the step.

How it went

Author reported: no more guessing what an 8-minute deploy is doing; the progress bar shows step and elapsed time in real time, and Mac notifications immediately signal completion or failure (author_report).

Worth knowing

The mod works with any script that can write a file, not tied to a specific deployment tool. Known limitations: specific JSON file path convention, mod installation details, and trap implementation code were not provided; macOS required for native notifications; not tested by this site (reproduction: not_tested).

Steps

  1. Generate and install the terminal mod with Claude Code

    Launch Claude Code in your terminal and describe the need: a mod for an existing deploy script that polls a JSON status file every 2 seconds, renders a progress bar above the prompt, highlights failed steps in red, and sends a Mac notification on completion or failure. Claude Code will generate the mod code and provide installation instructions (typically writing to a terminal config directory or running an install command). Complete the installation and confirm the mod is loaded.

  2. Modify the deploy script to output JSON status

    At key stages in your existing deploy script (before/after build, test, deploy, etc.), insert logic to write the current step as a JSON object {step: currentIndex, total: totalSteps, label: 'step name', state: 'running'|'done'|'failed'} to an agreed file path (e.g., /tmp/deploy-status.json or ~/.config/deploy-status.json). Ensure the script writes state: 'failed' on error and triggers error handling (e.g., via trap).

  3. Run the deploy and watch the progress bar and notifications

    Execute the modified deploy script. A progress bar should appear above the terminal prompt, showing current step, total steps, step label, and elapsed time. If a step fails, that step turns red and a Mac notification appears naming the failed step; on full completion, a notification shows success. Verify: the bar updates every 2 seconds, and long deployments no longer run silently.

Prompt you can copy

Reference prompt · Editorial suggestion。Confirm the destination, input variables and output format before use.

This block is the prompt. Ads are never placed here.

No prompt needed — just follow the steps.

Source

让 Claude Code 做个小 Mod：部署脚本每步写 JSON，输入框上方显示进度条，完成/失败弹 Mac 通知 · fuat_kerkinni · X · 2026-10-25T17:54:31.000Z

Comments & feedback

Tried this method? Share results, problems or improvements. Comments appear after moderation. Please avoid sensitive information.

Loading…

    Related