
Clownfish
github.com/openclaw/clownfish- Category
- AI Agents
- Rank
- No. 1423Tools index
Previous survey · No. 1434 ·
- Pricing
- Open Source
- Type
- AGENT
- Builder
- openclaw
- GitHub
- 60 stars
- Date
About
OpenClaw's maintainer codex harness for resolving clusters of issues identified in bulk at scale — point it at a triage backlog and it iterates.
What it does
Clownfish turns a preselected group of related GitHub issues and pull requests into a structured maintenance decision. A Codex worker classifies current evidence, while separate deterministic automation controls comments, closures, branch repair, replacement pull requests, and tightly gated merges.
Why it's ranked here
Its value comes from a careful split between judgment and authority. Codex proposes actions without GitHub write credentials, then deterministic checks revalidate live state before mutations. That design suits risky backlog maintenance, though the operational machinery is substantial and deliberately narrow.
What's good
The proposal-first workflow keeps uncertain items open and sends ambiguous cases to maintainers. Duplicate work guards, idempotent comments, stale-state checks, contributor credit, explicit merge gates, and separate security routing make automated cleanup traceable. Repair loops can update an existing branch or create a credited replacement.
Tradeoffs
Clownfish does not discover backlog clusters itself, and security-sensitive work must use another process. Effective operation depends on GitHub Actions, Codex, GitHub credentials, committed job definitions, environment gates, and careful promotion from planning to execution. Missing hydration, conflicts, failed checks, unclear intent, or stale state commonly stop automation for human review.
How to use it well
Use it as a second-stage maintainer system after humans or another tool group related work. Start in read-only planning, inspect the structured artifacts, then briefly open execution gates for approved clusters. It fits OpenClaw-specific issue cleanup and pull-request repair, not general backlog discovery or central security response.
Technical notes+
package.json defines a private ECMAScript-module package requiring Node 24 or newer, with command surfaces for validation, imports, dispatch, worker execution, mutation, finalization, and reporting. scripts/create-job.mjs generates idempotent job markdown, checks for existing branches or pull requests, and defaults generated work to autonomous mode with merge blocked. scripts/run-worker.mjs validates jobs, invokes Codex with structured output, records transcripts, and attempts constrained result repair after validation failures. scripts/lib.mjs centralizes job parsing, GitHub command execution, worker-capacity checks, and deterministic security signals. scripts/post-flight.mjs rechecks merge policy and live pull-request state before squash merging or post-merge closeout. docs/OPERATIONS.md and docs/INTERNAL_FEATURES.md describe the proposal, promotion, execution, and audit model.
Observed
- Primary language
- JavaScript using ECMAScript modules
- Packaging
- Private npm package requiring Node.js 24 or newer
- Interface
- Command-line workflows exposed through npm scripts
- Automation platform
- GitHub Actions coordinates planning, execution, repair, and finalization
- Worker boundary
- Codex proposes structured decisions without GitHub write credentials
- Scope
- Consumes preselected GitHub issue and pull-request clusters; does not discover the backlog itself
- Testing
- Package test command runs Node test files matching test/*.test.mjs
Read from README.md, package.json, docs/OPERATIONS.md, docs/auto-update-prs.md, docs/INTERNAL_FEATURES.md, scripts/lib.mjs, scripts/create-job.mjs, scripts/run-worker.mjs, scripts/post-flight.mjs.
What it can do
Analyze triage backlog for issue clusters
Triage backlog of software issues → Identified clusters of related issues
Resolve clusters of issues in bulk
Clustered software issues → Resolved issue clusters
Iterate through issue resolution process
Queue of issue clusters → Processed and resolved issues
Scale issue resolution across large codebases
Large volume of software issues → Systematically resolved issues at scale
Harness OpenClaw maintainer codex
OpenClaw maintainer codex data → Applied maintenance patterns and solutions
Tags
Tech Stack
Media
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.