mcpField
C
clawsweeper-status

clawsweeper-status

github.com/steipeteCloud & DevOps7.4k95 installsUpdated 1w ago
Repository

About clawsweeper-status

A skill that runs a bundled script to report ClawSweeper workflow and queue status for a target repository. It organizes recent repository activity and explains queue states and capacity context.

Key features

  1. 01Report worker and workflow status
  2. 02Summarize queue health and backoff
  3. 03Show publication queue metrics
  4. 04List recent merges, reviews, and comments
  5. 05Support repository, time-window, and row-limit options

Use cases

  1. 01Check ClawSweeper activity for a repository
  2. 02Identify parked items awaiting an operator
  3. 03Review recent merged and closed items
  4. 04Inspect queue capacity and retry status

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/steipete/agent-scripts --skill clawsweeper-status

After installing, type/clawsweeper-statusin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

agents/
openai.yaml
scripts/
clawsweeper-status.sh
clawsweeper-status.test.sh
scripts/fixtures/
public-exact-review-queue.json

Details

From the project README

ClawSweeper Status

Quick Start

Run the bundled status script first:

/Users/steipete/Projects/agent-scripts/skills/clawsweeper-status/scripts/clawsweeper-status.sh

Useful options:

# Last 10 hours for the default target repo, openclaw/openclaw
/Users/steipete/Projects/agent-scripts/skills/clawsweeper-status/scripts/clawsweeper-status.sh --hours 10

# A different target repo
/Users/steipete/Projects/agent-scripts/skills/clawsweeper-status/scripts/clawsweeper-status.sh --repo openclaw/clawhub

# More rows per activity section
/Users/steipete/Projects/agent-scripts/skills/clawsweeper-status/scripts/clawsweeper-status.sh --limit 15

Output Contract

Report these sections concisely:

  • Workers: workflow state, Codex jobs against configured capacity, exact-review queue and target occupancy when available, and active workflow groups. Public queue aggregates remain usable without private target occupancy; occupancy unavailable does not mean zero.
  • Queue health: lead with this whenever it is not healthy. Pending depth on its own is not a verdict — read the split the script prints underneath it:
    • ready/admissible near zero while pending is deep means the lane is deliberately holding items back, not stalled.
    • Queue backoff: throttle_retry N means GitHub is rate-limiting; the lane recovers on its own once quota returns.
    • Queue parked (needs operator): review_retry_exhausted N does not self-heal. Parked items retry at 5/10/20 minutes and then wait for a human. Always call these out explicitly.
    • Shed since reset climbing into the thousands means sustained overload, not a blip.
  • Publication tail: aggregate pending/ready/backoff/parked/active counts and capacity when available, plus retry and parked reasons. This is separate from the review backlog, not per-target activity; legacy responses without this lane report unavailable.
  • Recently merged: merged PR URLs plus one-line titles.
  • Recently reviewed: ClawSweeper/Codex review comment URLs plus one-line comment summary.
  • Recently commented: other recent ClawSweeper comment URLs plus one-line comment summary.
  • Recently closed: closed issue/PR URLs plus one-line titles.

If the script returns no rows for a section, say none found in window.

Active workflow groups are capped at 20, ordered by descending run count; activity sections are capped at --limit rows. Large workflow snapshots must still reach all activity sections. Required fetch/parser failures remain fatal; optional queue/capacity telemetry can remain unavailable.

Efficient Data Sources

Prefer the script because it uses bounded API calls:

  • field-bounded Actions run queries and bounded active-job probes from openclaw/clawsweeper;
  • the small automation-limits config and exact-review queue status endpoint for capacity context;
  • recent issue comments for review/comment URLs;
  • a field-bounded closed-item search for close URLs and actors;
  • field-bounded recent merged PRs.

Do not browse the web for these checks. Use gh directly.

Interpretation

  • Cancelled repository-dispatch review runs are usually expected supersession when a newer event for the same item arrives.
  • Count Codex usage from actual in-progress/queued jobs; use setup-action steps plus known lane names to identify Codex work.
  • Treat pending workflow runs as concurrency waiters, not queued Codex jobs.
  • Treat stale worker counts cautiously; compare the status-filtered gh run list results with the default recent-run list when numbers disagree.
  • Queue reads stay unauthenticated. Public oldest-pending age is useful without a private item key; missing health counts remain unknown, not zero.
  • Use full GitHub URLs in the final answer.

Comments

Markdown supported