Repository navigation
Releases
HolyCrab Agent Tools v0.7.1
HolyCrab Agent Tools v0.7.1
Adds MiniMax H3 Highspeed (768P) and H3 Lite (480P/768P), both 4–15 integer seconds, to CLI, MCP and creative workflows. The catalog now contains 13 video, 4 image and 1 audio models. Existing v0.7.0 creative workflows and local composition remain available.
Text generation requires a concrete ratio. Highspeed references support adaptive; Lite references require a concrete ratio. First/last-frame requests use adaptive. Prompt limits match the backend (7000 UTF-16 code units). Material validation stays backend-owned; failed estimates never submit a paid task. Existing price rechecks and uncertain-outcome recovery remain in place.
Skill content version is 1.0.1 with CLI 0.7.1 as its minimum runtime. Distribution bundles and both installers are generated from the runtime inventory. Upgrade from 0.7.0 preserves configuration, Skills ownership and workflow records.
Both new models completed one authorized minimum-spec real generation, download and full media decode (18 and 8 credits). A 4-second request returned 3.75 seconds for Highspeed and 4.46 seconds for Lite; exact output duration is not guaranteed. Automated coverage includes all 18 model routes and unchanged v0.7.0 creative workflows. Native Windows/Linux CI and draft installation are required before publication. Existing authorization/upload evidence is reused only for byte-identical components; no new identity verification or personal upload is claimed. Kling is not included.
Download reliability fixes
Workflow downloads retain the absolute destination approved in the estimate even after changing the working directory or home. Empty successful HTTP responses are rejected before file replacement, preserving existing output and cleaning temporary files. Independent review reproduced both failures; regression tests cover relative/home paths and empty fixed-length, chunked and lengthless responses.
HolyCrab Agent Tools v0.7.0
HolyCrab Agent Tools v0.7.0
Describe a video, image or voiceover in Codex and HolyCrab selects the relevant creative guide, prepares the request, quotes credits and executes within your approval.
- Bundle five creative guides: video production, product images, voiceovers, Seedance prompts and H3 storyboards, behind one automatically selected HolyCrab Skill.
- Save and resume multi-step workflows. Query existing tasks after interruptions, reuse completed outputs and revise individual shots without silently generating duplicates.
- Download clips and compose a finished MP4 locally with trimming, canvas normalization, music, narration and timed Chinese/Latin subtitles. Local composition requires working FFmpeg and FFprobe. Automatic transcription is not included.
- Show concise terminal progress and useful recovery actions.
--json-outputexposes full creative records; piped output remains JSON. Distinguish API Key quota from account balance. - Provide self-contained CLI and individual Skill archives, with bundled resource hashes and installation ownership checks.
Install or update
Use the attached installers or run holycrab update. Reopen Codex after installation so it discovers the new Skill. Python 3.10 or newer is required. Keep your API Key in local setup.
The complete archive contains LOCAL-INSTALL.md: extract it and use the local-source installation command there. Individual .skill files require an installed CLI 0.7.0 or newer.
Validation scope
The creative Agent flow was validated with Codex on macOS: one real silent Seedance Mini video, interrupted-wait recovery, verified download, timed Chinese subtitles and complete MP4 decoding. Nine additional local media scenarios passed. Audio generation and other Agent hosts were not newly live-tested for this release. Native platform installation and protocol checks run in CI; Codex reply brevity can still vary with the host/model.
Existing authorization/upload implementation bytes are unchanged from v0.6.0. Its recorded live upload evidence is reused with explicit component hashes and fresh read-only queries; no new identity verification or personal-media upload is claimed. Windows v0.5.0 self-update retains its known old-launcher limitation; use the installer for that upgrade path.
HolyCrab Agent Tools v0.6.0
HolyCrab Agent Tools v0.6.0
v0.6.0 adds four Berry models, aligns material references and validation with the backend, and improves upload, generation, update and Windows reliability. Python 3.10 or later is required.
Models and materials
- Add
berry-1.0,berry-1.0-turbo,berry-1.0-proandberry-1.0-pro-turbo, bringing the bundled CLI/MCP catalog to 16 models. - Preserve structured material errors, request IDs and metadata across CLI, JSON and MCP. Model suitability is decided by the backend; missing or pending metadata is not a new local generation blocker.
- Support
imageAssetIdsfor image generation, with backend ID priority when URLs are also supplied. Audio references accept asset IDs or URLs, and audio estimates send the complete normalized request. - Add
holycrab assets metadata retry ASSET_IDand its MCP tool. Retrying is explicit; the CLI does not loop automatically. Old Base64 orspeakeraudio references receive migration guidance.
Reliability and Windows
- Validate estimates and recheck approved prices before generation. Preserve known task and asset IDs when saving local state fails; never automatically repeat an uncertain paid submission or upload.
- Freeze confirmed upload bytes, prevent concurrent reuse of a plan, and retain recovery records. Inspect a batch with
holycrab assets uploads get PLAN_IDorasset_upload_plan_get. - Reject truncated and partial downloads before replacing existing files. Report failed or uncertain MCP mutations with
isErrorwhile retaining recovery details. - Improve installation integrity, update rollback, credential handling, cancellation and delayed Windows cleanup. Preserve user files, customized Skills and unrelated MCP registrations.
- Accept UTF-8, UTF-8 BOM and BOM-marked UTF-16 request files. Verify PowerShell 5.1, PowerShell 7 and CMD launchers. Windows installation directories containing
%or!are rejected with guidance to choose another directory.
Updates
From an installed version that supports the update command:
holycrab update --check
holycrab update
holycrab --versionThe update command asks before installing. In v0.6.0, ordinary CLI use and long-running MCP sessions check for stable updates at most once per day, retry a failed check after one hour, and avoid repeated reminders. Update notifications never install automatically. Older installations must use their existing update command to discover this release; the new notification behavior starts after upgrading.
Known Windows v0.5.0 upgrade issue
A post-release native Windows check found that holycrab update --yes from v0.5.0 can complete the v0.6.0 installation but return exit code 123 and a filename-syntax error from the old CMD launcher. The subsequent holycrab --version and holycrab doctor --json checks reported 0.6.0 and healthy runtime. This command path is recorded as failed, not a clean successful update.
For Windows upgrades, rerun the official Windows installer and then check the version and doctor result. Fresh v0.6.0 installation is unaffected. Published v0.6.0 files and its tag remain unchanged; this note records the observed post-release limitation.
Validation scope
Automated coverage includes all 16 model routes, 22 MCP tools, installed HTTP fault scenarios, ten behavioral mutation checks, and native Windows/macOS/Linux verification. A real upload/query check reused an existing authorized person, preserved the original asset and verified downloaded bytes. New liveness verification and paid generation were not performed. Windows 10/11 x64 desktop validation was explicitly excluded; tested Windows Server and ARM environments do not imply coverage of every desktop configuration.
HolyCrab Agent Tools v0.5.0
HolyCrab Agent Tools v0.5.0
Add MiniMax H3 Max, Agnes Video 2.5, and Agnes Image 2.5 Flash to the shared CLI/MCP release snapshot: 7 video, 4 image, and 1 audio models. Requests use each model's native HolyCrab fields and exact estimate/create routes. Account results expose valid disabled_models; unknown permission is never treated as granted access.
Retain one-shot paid submission, uncertain-outcome recovery, public-output filtering, and Windows DPAPI credential protection. Both Unix and Windows installers verify SHA-256 hashes. Publish only after the Generate contract, recorded real-person acceptance, and native installation gates pass. Ken confirmed reuse of prior real-person authorization/upload acceptance for this model-only release; unchanged core code is checked by a pinned fingerprint. No new live real-person test or successful live generation is claimed. Website installers must match immutable Release assets byte for byte.
Generate contract validation uses the user-authorized local synchronized-main path for v0.5.0, pinned to the recorded remote commit and validated CLI file hashes. Cross-platform tests and native Release installation remain required.
HolyCrab Agent Tools v0.4.4
HolyCrab Agent Tools v0.4.4
This release fixes installation choices and recovery during updates.
- Fresh installations include the CLI and Codex/Claude Skills. Reinstallation and updates preserve the existing Agent and MCP choices, including installations without Agent integration.
- The installer also understands blank settings sent by older updaters and recovers the previous choice from the installation record.
- All downloaded and local-source files are verified using SHA-256 before execution or replacement. Windows DPAPI credential protection is retained.
- Failed updates report bounded, sanitized installer diagnostics. Missing or inconsistent installation records stop an update before it changes files.
- Recovery restores only managed files changed by the installer, including its HolyCrab MCP changes. Unselected Skills and unrelated files are retained. Incomplete recovery keeps the backup and reports its location.
- No public commands, parameters or MCP tools are added. API Keys, attempts and user state are preserved during normal installation and uninstallation.
- Online health checks distinguish an optional, never-configured Agent from a broken managed connection. Connection repairs point to the installer rather than a no-op version update.
Installation and update
Users with an updater can run holycrab update. Users on v0.4.0 can run the installer again. Always use the matching Windows or macOS/Linux installation instructions.
The v0.4.3 tag and assets remain immutable. v0.4.4 replaces it as the recommended version only after release checks pass.
Verification
Publication requires the full regression suite, native installation checks, release digests and the v0.4.4 acceptance record. Generate is checked against synchronized local main. Real-person production commands are excluded at the user's request and will be manually checked after release.
The authorized live test uses one image, one video and one audio generation, plus up to three ordinary image uploads. Their actual outcomes and cost evidence are recorded in the acceptance report; tests and mocks are not installed on users' computers.
HolyCrab Agent Tools v0.4.3
HolyCrab Agent Tools v0.4.3
This version improves installation and first-use guidance, local account checks, Agent-registration cleanup and release validation, retaining the business-focused onboarding introduced in v0.4.2.
Highlights
- Records the actual Codex/Claude Code client path, the complete MCP command and arguments, and installer ownership without storing an API Key. Uninstall and online doctor can locate clients outside the current PATH.
- Compares complete commands and arguments before cleanup. Claude removal is restricted to user scope; manual registrations, other Agents and unrelated MCP entries are preserved.
- Explicitly reports pending Agent cleanup rather than claiming a complete uninstall. A matching registration removal failure stops cleanup before program deletion. Keeping a pre-existing or shared PATH is informational.
- Handles the UTF-8 BOM produced by Windows PowerShell 5.1 pipelines when registering MCP. Chinese installation paths, strict version validation and SHA-256 checks remain supported.
- Retains first-use onboarding, Windows DPAPI migration, two-stage uploads and one-shot paid-submission protection. No public commands or MCP tools are added.
- Uses short headings and lists for interactive results and first-use guidance. Installers no longer print internal Agent rules, and setup does not repeat its full JSON in a terminal. Piped/script output, explicit JSON modes and MCP structured results retain their existing format.
- Groups installation into five stages. Reinstallation and upgrades do not repeat the first-use business introduction; failed health checks show diagnostics rather than a full JSON report.
- Summarizes model/task/person/attempt lists, task outputs, authorization states, uploads and downloads. Upload previews still show every selected file and exact target before one confirmation; partial batches retain the failed/unknown and unattempted inventory.
- Wraps explanations without splitting commands or paths. Unknown submissions retain their no-retry warning; unsuccessful recent-task searches are not proof that no task was created. Skill guidance uses concise user-language replies, with separate upload and paid-generation confirmation.
- Offline doctor reports
CONFIGUREDfor a configured Key, not failed verification or a connected account. Agent guidance retains prior valid checks in the same conversation without repeating verification merely for offline doctor. - Removes the old standalone API, polling and upload script; unique transport-security tests now exercise the main CLI. Hidden
auth set-keyandcredits estimatecompatibility aliases continue to use the main implementations. - Shares one immutable capability snapshot/model index per operation, and throttles expired QR scans per configuration directory to five seconds. Terminal authorization cleanup remains immediate.
- Moves all fixtures, mocks, smoke drivers and test dependencies to top-level
tests/, and development validators totools/. Installations contain only the explicit runtime and Skill whitelist; no user-facing Mock switch is provided. - Validates executable guidance against the actual parser and MCP schema. For this v0.4.3 release only, the user approved checking synchronized local Generate main; CI verifies the recorded commits and exact CLI input hashes without private-repository credentials. The user's previous real-person acceptance is explicitly reused, not reported as a new live-flow test. Future releases retain their existing remote-contract and manual-acceptance requirements. Releases remain Draft until SHA-256 digests, downloaded bytes and native installation checks pass.
Installation and update
Installers replace the program at the same prefix after validating downloads. Managed files are temporarily backed up and restored on failed post-install checks; successful installation removes the temporary backup. Local credentials, attempts, upload plans and user settings are preserved. The CLI does not keep two runnable versions side by side.
Official entrypoints must only be switched after this release is published and verified. Before publication, test users must use a verified fixed commit with HOLYCRAB_INSTALL_REF. Older v0.4.0 installations have no updater: rerun the official installer after v0.4.3 is published.
Verification
Tests use mocks, temporary installations and read-only Generate source. No production tasks, authorizations, uploads, renames or online deletions are performed. Upgrade fixtures cover v0.4.0, v0.4.1 and v0.4.2. Native PowerShell 5.1 tests execute the pinned colleague command and check delayed self-deletion within 10 seconds. Real beginner conversations remain a separate manual acceptance check.
HolyCrab Agent Tools v0.4.0
HolyCrab Agent Tools v0.4.0
This release adds native Windows PowerShell installation and removes the common post-install PATH failure on macOS and Linux.
Highlights
- Adds a SHA-256-verified
install.ps1for Windows 10/11, Windows PowerShell 5.1, and PowerShell 7. - Installs a
holycrab.cmdlauncher and activates the user PATH in the current and future PowerShell sessions. - Saves
~/.local/binto the detected zsh, bash, or POSIX shell profile without duplicating entries. - Adds Windows CLI and local MCP installation gates to CI.
Requirements: Python 3.10+; macOS/Linux also require curl.
HolyCrab Agent Tools v0.3.0
HolyCrab Agent Tools v0.3.0
Adds real-person authorization and management to the CLI and local MCP: show a private verification link and offline QR image, query the result, upload reference media to the authorized person's group, wait until it is ready, rename people, and permanently delete a selected group or asset.
- Bundles Segno 1.6.6 and its BSD-3-Clause license. Installation requires no additional Python packages; release files are verified with SHA-256.
- Keeps provider tokens and internal identifiers out of public responses. QR cache files use user-only permissions and expire without a background service.
- Rejects unexpected verification origins and upload redirects. Destructive tools require explicit confirmation, identify their target first, and never retry an uncertain deletion.
- Preserves the existing Seedance 2.5 and Seed Audio capability snapshot, API Key setup, credit estimation, and one-confirmation/one-generation submission rule.
The production API and official browser callback must support this flow. Human verification is performed by the person and does not constitute consent to paid generation.
HolyCrab Agent Tools v0.2.1
This release packages the HolyCrab CLI, local MCP server, and Agent Skill for macOS and Linux.
Highlights
- Adds a versioned public capability snapshot with request schemas for Seedance, MiniMax H3, Seedream, and Seed Audio.
- Adds 1080p support metadata for Seedance 2.5 and complete image and audio input limits.
- Keeps production API routing inside the CLI and removes API endpoint paths from public capability responses.
- Fixes local asset registration to use the production multipart form contract.
- Defaults supported Seedance video requests to generated audio while preserving an explicit silent-video choice.
- Limits public account output to the minimum identity fields and available credit needed for generation.
- Rejects custom API origins and runtime capability overrides before an API Key is read.
- Installs
agents/openai.yamland verifies every remotely downloaded release payload with SHA-256.
Install
Requirements: macOS or Linux, Python 3.10+, and curl.
curl -fsSL https://raw.githubusercontent.com/AstroxNetwork/skills/v0.2.1/install.sh | shRun the same command again to upgrade or repair an installation. Local API Key configuration and task history are preserved.
Paid-task safety
The CLI estimates credit first and requires explicit confirmation before creating one billable task. It does not automatically retry a paid submission after an ambiguous network result. Intentionally repeating the same prompt remains supported as a new confirmed draw.
Validation
The release gate covers Python unit tests, compilation, capability consistency, the official Skill validator, macOS/Linux installation, MCP initialization, SHA-256 tamper rejection, and public-boundary scanning. Release validation does not submit a paid generation task.
HolyCrab CLI collects no additional telemetry. Service use is governed by the Privacy Policy and Terms of Service. For support, contact cs@holycrab.ai.