Skip to content

docs: add claude-watch to Available Plugins#761

Open
satsuki19980613 wants to merge 2 commits into
siteboon:mainfrom
satsuki19980613:add-cloudcli-claude-watch-to-readme
Open

docs: add claude-watch to Available Plugins#761
satsuki19980613 wants to merge 2 commits into
siteboon:mainfrom
satsuki19980613:add-cloudcli-claude-watch-to-readme

Conversation

@satsuki19980613
Copy link
Copy Markdown

@satsuki19980613 satsuki19980613 commented May 12, 2026

What is this plugin?

cloudcli-claude-watch is a CloudCLI plugin adapter for claude-watch, a watchdog tool for Claude Code.

When Claude Code stalls (a common pain point for long-running sessions), claude-watch writes stall alerts to ~/.claude/watchdog.log. This plugin surfaces those alerts as a CloudCLI tab so you can:

  • See active stalls with process details (cmdline, cwd, uid, start time, git branch)
  • Kill the offending PID with SIGTERM/SIGKILL via a confirmation dialog
  • Identify stalls belonging to the currently selected project (highlighted in blue)

Verified on CloudCLI v1.31.5

Installed via Settings → Plugins (git URL), dogfooded end-to-end:

  • Tab renders with live polling
  • Stall row expands → shows process + git details
  • SIGTERM dialog appears and kills the process
  • In-project highlight works when the stall's cwd matches the active project

Screenshots

Empty state Stall expanded Kill dialog In-project highlight
empty expanded kill in-project

Full screenshot index: docs/screenshots/README.md

Details

  • Install: paste https://github.com/satsuki19980613/cloudcli-claude-watch.git into Settings → Plugins
  • License: MIT
  • Prerequisite: @satsuki0710624/claude-watch running and writing to ~/.claude/watchdog.log
  • Maintainer: @satsuki19980613

Summary by CodeRabbit

  • Documentation
    • Added the "claude-watch" plugin to Available Plugins. Visible features: watchdog log with tab-level visibility, expandable process details, controls to terminate offending PIDs, and highlighting of stalls scoped to the current project.

Review Change Stack

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 12, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 62043b8a-ee01-48b3-b316-45f3ecd37caa

📥 Commits

Reviewing files that changed from the base of the PR and between 64ae95b and ae5483b.

📒 Files selected for processing (1)
  • README.md
✅ Files skipped from review due to trivial changes (1)
  • README.md

📝 Walkthrough

Walkthrough

This PR adds a new plugin entry to the README's Available Plugins table. The "claude-watch" plugin is documented as providing watchdog functionality to surface Claude Code stalls with tab-level visibility, expandable process details, controls to kill the offending PID, and highlighting stalls for the current project.

Changes

Plugin Documentation Update

Layer / File(s) Summary
claude-watch plugin documentation
README.md
Inserted a new "claude-watch" row into the Available Plugins table linking to its repository and describing stall detection with tab-level visibility, expandable process details, controls to kill the offending PID, and project-specific stall highlighting.

🐰 A watchdog hops into view,
Spotting stalls that code can do,
With logs and tabs so crystal clear,
No stall escapes our furry seer! 🔍

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'docs: add claude-watch to Available Plugins' directly and accurately describes the main change: adding documentation for the claude-watch plugin to the README's Available Plugins table.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Tip

💬 Introducing Slack Agent: The best way for teams to turn conversations into code.

Slack Agent is built on CodeRabbit's deep understanding of your code, so your team can collaborate across the entire SDLC without losing context.

  • Generate code and open pull requests
  • Plan features and break down work
  • Investigate incidents and troubleshoot customer tickets together
  • Automate recurring tasks and respond to alerts with triggers
  • Summarize progress and report instantly

Built for teams:

  • Shared memory across your entire org—no repeating context
  • Per-thread sandboxes to safely plan and execute work
  • Governance built-in—scoped access, auditability, and budget controls

One agent for your entire SDLC. Right inside Slack.

👉 Get started


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@README.md`:
- Around line 168-169: Add a single blank line between the plugins table and the
following "Build Your Own" heading in README.md to satisfy markdownlint rule
MD058; locate the table row containing the claude-watch entry and ensure there
is an empty line immediately after the closing table line before the "Build Your
Own" heading so CI/docs lint will pass and then run the build (npm run build) to
verify.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: e4b394ca-fd79-4a6b-b4f0-a10d8921885f

📥 Commits

Reviewing files that changed from the base of the PR and between 039696c and 64ae95b.

📒 Files selected for processing (1)
  • README.md

Comment thread README.md
@blackmammoth
Copy link
Copy Markdown
Collaborator

blackmammoth commented May 12, 2026

Hey there! Thanks for the PR. I'm sure it will be useful for many people. Can you put the log file in ~/.cloudcli/plugins/<your-plugin>/watchdog.log instead. It will be easier to keep to track of which files are and aren't from plugins for the future.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants