v0.5.0

Wombat v0.5.0

Find past decisions, understand local usage, diagnose project problems and review cleanup through Wombat in Codex. This release simplifies the CLI and task guidance while preserving accounting results.

Highlights

• Use five CLI entries: usage, check, system, api and call. Detailed capabilities remain available through generated requests; accounting totals and pricing rules are unchanged. Previous top-level commands are removed without aliases. Update the Codex plugin together with the runtime using the installer plugin option.
• Review rebuildable project outputs and six kinds of Codex artifacts: desktop caches, application update stages, marketplace stages, obsolete daemon releases, incomplete runtimes and old crash reports. Codex cleanup is limited to supported macOS layouts. Inspect first, then permanently remove only authorized selected candidates; final checks retain current and pending versions and hold the daemon installation lock during obsolete-release removal.
• Read long conversations and review evidence by selected dates, tasks and turns. Bounded indexes select relevant event blocks instead of loading unrelated history, while usage totals, quality states and original-view checks retain their meaning.
• Use task guidance for queries, diagnosis and verification. Known project problems can use current files directly; historical investigation reads only evidence that can change the decision. Suggestions identify a concrete owner, smallest change and original check to rerun.
• Recover from resource-limited historical queries by narrowing the evidence scope while keeping full-scope usage totals separate. Cleanup guidance reuses existing authorization and avoids duplicate pre-apply checks or native deletion that bypasses a blocked result.
• Start from short usage, improvement and cleanup examples in the English or Chinese README. Installation and updates retain one documented runtime-and-plugin path; local analysis, model evidence access, estimates and permanent deletion have explicit boundaries.

Install or update

macOS and Linux:

curl -fsSL https://raw.githubusercontent.com/YannByte/wombat/main/scripts/install/install.sh | sh

Windows PowerShell:

& ([scriptblock]::Create((irm https://raw.githubusercontent.com/YannByte/wombat/main/scripts/install/install.ps1)))

Update an installer-managed copy:

wombat system update --check
wombat system update

Supported archives: darwin-arm64, darwin-x64, linux-x64, linux-arm64, win32-x64.

Known limitations

• The CLI surface is intentionally changed. Old top-level command names have no compatibility aliases. Use api and call for the generated detailed methods, and refresh the Codex plugin when updating the runtime.
• Codex is the only production history source. Native plugin discovery requires a compatible local Codex. Supported Codex artifact cleanup currently targets macOS; it does not provide arbitrary-path deletion. General project cleanup remains with authorized native or project tools.
• Codex apply is permanent and has no automatic restore or persistent cleanup history. Changed, incomplete, locked or unknown conditions block removal. Filesystem and process observations outside the installation lock are not a universal atomic transaction, and an absent path does not prove freed disk space.
• Large period reviews and detailed evidence queries can still return RESOURCE_LIMIT. Narrow the dates, task or turn and preserve partial or unavailable results; samples do not establish complete coverage. No hard request-latency or process-memory limit is promised.
• Wombat CLI queries make no model calls or log uploads, but selected evidence read by the Skill enters the current Codex conversation and consumes model Tokens. Missing prices may trigger an official catalog download. API-equivalent costs remain estimates and are separate from subscription allowance.
• Original-text access is limited to supported message mappings and text parts. Unknown mappings, non-text content, incomplete sources and changed evidence remain explicit gaps. Unsupported derived formats are rejected without migration or automatic deletion; preserve user decisions when following documented recovery.
• A verified immediate fix does not prove later adoption, causal savings or better outcomes. Missing use records, high usage and repeated attempts alone do not establish waste.

Verification and security

All five archives were built and exercised on their target platforms from commit 29131bc40ea00917707060306e313d79344e2f76. Installers and updates verify the published size and SHA-256 digest before switching versions. GitHub provides build provenance attestations for the platform archives. Wombat reads local sources without changing them; network behavior and native handoff follow the documented privacy boundaries.

Feedback and changes

Report problems in GitHub Issues. Private security reports should follow the security policy.

Changes since v0.4.0: compare v0.4.0...v0.5.0