---
title: "Wrote a Claude Code mod utility bg-watch, mainly used to watch background-running Shell tasks and AI Sub-agent progress. Now I often let Ag"
url: "https://claudemods.dev/en/builds/claude-code-mod-bg-watch-shell-ai-sub-agent-ag-bc33ac"
source: "https://github.com/hmj1026/bg-watch"
source_type: "github"
repo: "https://github.com/hmj1026/bg-watch"
author: "Paul Ho"
author_handle: "paul009th"
stars: 0
category: "Multi-agent orchestration"
categories: ["agents"]
tags: ["alerts", "background-tasks", "progress-monitoring", "shell", "subagents"]
permission_level: 2
scan_complete: true
install: "claude plugin marketplace add hmj1026/bg-watch\nclaude plugin install bg-watch@bg-watch"
added: "2026-11-19T05:17:05.786Z"
updated: "2026-11-19T03:12:09Z"
locale: "en"
content_locale: "en"
---

# Wrote a Claude Code mod utility bg-watch, mainly used to watch background-running Shell tasks and AI Sub-agent progress. Now I often let Ag

bg-watch is a Claude Code utility for monitoring background-running Shell tasks and AI sub-agent progress, and proactively alerting when status changes or errors occur.

## Description

Wrote a Claude Code mod utility bg-watch,
mainly used to watch the progress of Shell tasks and AI Sub-agent running in the background.

These days I often have the Agent dispatch sub-agents or throw background scripts at things to process them in parallel, but after sending them off I often don't know whether it's still running, stuck, or has already quietly finished. This tool simply watches the output and status of these background processes for you, proactively alerting you when there is a progress change or when it finishes with an error, so you don't have to keep switching windows and running commands yourself to check.

Anyone with similar needs is welcome to take a look:
https://github.com/hmj1026/bg-watch

## Install

```
claude plugin marketplace add hmj1026/bg-watch
claude plugin install bg-watch@bg-watch
```

## Original README

寫了一個Claude code mod 小工具 bg-watch，
主要用來盯在背景跑的 Shell 任務和 AI Sub-agent 進度。

現在很常讓 Agent 派子代理或丟背景腳本平行處理事情，但丟出去後常常不知道它現在是還在跑、卡住了，還是已經默默結束。這個工具就是單純幫你盯著這些背景進程的輸出與狀態，有進度變化或跑完噴錯時主動提醒，不用一直切視窗自己下指令查。

有類似需求的人歡迎參考看看：
https://github.com/hmj1026/bg-watch
