Codewhale is an open-source coding agent that runs in the terminal and can read repositories, edit files, execute commands, and inspect results while pursuing a task. Developers use it with hosted providers or local models, with controls for how much access it receives.
Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add Hmbown/Codewhale --skill recordinggit clone --depth 1 https://github.com/Hmbown/CodewhaleWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/hmbown/codewhale/recording)<a href="https://agentmods.dev/skills/hmbown/codewhale/recording"><img src="https://agentmods.dev/badge/skills/hmbown/codewhale/recording/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/hmbown/codewhale/recording"><img src="https://agentmods.dev/badge/skills/hmbown/codewhale/recording.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00027 | $0.00379 |
| Opus 5.5 | $0.00011 | $0.00152 |
| Sonnet 5.5 | $0.00005 | $0.00076 |
| Haiku 4.5 | $0.00003 | $0.00038 |
Grade A, and why
recording scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
What it actually says
Recording and screenshots
- Pick the computer (
computer_list, or passcomputer— it switches). - Check
request_accesswhen readiness is unknown. On a supported target, userecording_startwith optionaldisplay,region,fpsanddurationSec(macOS auto-stop), orintervalMs(HarmonyOS snapshot cadence). - Do the work (or let the user do it).
recording_stopwith the returnedid→ finalized file path + bytes.recording_listshows everything saved;recording_statuschecks one.
Platform truths:
- macOS: ScreenCaptureKit inside the signed helper captures a display or
region straight to .mov — no system recorder selection UI and no desktop
dimming overlay. If capture is denied, Screen Recording permission is
missing for whoever ran it: the Codewhale Computer Use app when
request_accesssaysvia: "app", else the terminal that hosts the server — tell the user which, do not retry. - Windows and Linux: recording is unavailable pending session-owned recorder cleanup. Use screenshots; installing ffmpeg does not enable it.
- HarmonyOS: no native CLI recorder; the backend captures
snapshot_displayframes atintervalMsand muxes with ffmpeg on stop. The receipt labels the modesnapshot-series— never call it real-time.
Screenshots: screenshot returns the saved path and raster geometry; zoom
crops the latest raster when a target is too small to read.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 1mo ago Changed · -1 lines · -2 tokens per session 37eebb2ead9f
- 1mo ago Changed · +2 lines 1dab85436aec
- 1mo ago First seen · 31 lines · 29 tokens per session scan A 809ccbcb10ca
recording is a skill published in the GitHub repository Hmbown/Codewhale (41,035 stars, last pushed 26d ago), licensed MIT. It adds 27 tokens to every session and 379 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-06.
Other skills, from other repositories
contributor-onboarding
Help a new contributor get productive on this checkout - inspect sync state against main, build, run the repository's exact verification gate, and produce a local what's-new digest. Never fetches, pulls, or modifies a dirty tree on its own. Explicit-only.
codew-release-qa-sweep
Use before claiming Codewhale release work is done: run the full gate sweep and list the manual QA targets.
gh-compile-issues
Triage N GitHub issues into a coverage matrix: fetch each, check current code, classify already-done/quick-fix/design/defer with cited evidence.
gh-file-issue
Use when filing a new Codewhale GitHub issue: turn a bug or idea into a well-formed, actionable issue with repro, acceptance criteria, labels, and milestone.
gh-find-prs
Survey open Codewhale PRs and triage each for mergeability and disposition against the real landing branch.
best-of-n
Generate a small set of independent candidate solutions in worktrees, judge them against one explicit rubric, and apply the winner only after PASS verification.