AgentMesh-CreatorCut

AgentMesh-CreatorCut is the public execution product for CreatorCut: an Agent for intelligent post-production of talking-head videos and product screen recordings.

M1 is designed for Chinese, English, and mixed-language recordings. The public client keeps media processing local, renders Director-driven interactive cards across hosts, verifies signed edit plans, previews changes, and applies only declarative reversible operations.

Install

macOS or Ubuntu:

curl -fsSL https://raw.githubusercontent.com/jiyangnan/AgentMesh-CreatorCut/main/scripts/install.sh | bash

Windows PowerShell:

irm https://raw.githubusercontent.com/jiyangnan/AgentMesh-CreatorCut/main/scripts/install.ps1 | iex

The installers set up the pinned Node runtime, Git, FFmpeg, whisper.cpp, multilingual transcription model, secure credential backend, CLI shim, and signed managed-update channel. Then run:

creatorcut doctor
creatorcut auth login

See supported platforms for the exact macOS, Ubuntu, Windows, architecture, and dependency contract.

Current status

AgentMesh-CreatorCut M1 Cycle 1–5 is complete and public stable v0.2.0 is available through the signed managed-install channel. Production cloud admission is open for the Director main feature at the AgentMesh Core authoritative price of 50 credits. This repository contains the frozen public Protocol v1 plus a source-buildable local runtime, Director verification code, cross-platform secure credential adapters, stable JSON CLI, public MCP server, semantic card/text presentation adapters, local media import, Chinese/English/mixed whisper.cpp transcription, local Manifest preview/apply/undo/redo, and resumable export.

Batch 3 now includes the independent creatorcut-operations/1.0 contract, immutable *_ref resolution, a real Server-generated signed remove_range fixture, the complete advertised-operation test matrix, Codex MCP App code, the public OpenClaw Skill, generic-text fixture submission, and named session/Generation/preview/export recovery tests.

Cycle 3 is closed for the M1 support matrix: the real Codex native presentation and submit gate, the real OpenClaw Skill run, generic-text fallback, and the four-point recovery matrix passed with one fixed fixture and AnswerSet digest. Claude Code is deferred to a post-M1 compatibility iteration and is not an M1 supported or release-tested host. Its source preview remains under skills/claude-code but is excluded from support claims.

Cycle 4 added the managed installer and signed release chain. Cycle 5 completed the real GitHub RC/stable tag and canonical archive, staging signed Manifest, original-color three-material dogfood, production dark deployment, approved 50-credit paid canary/rollback, persistent Core stable ReleaseManifest and a formal clean public-channel reinstall with real Server/Core preflight.

The public repository is the release carrier, while availability, admission, and the authoritative 50-credit Director price remain controlled by AgentMesh Core.

Product boundary

AgentMesh-CreatorCut (public, local execution)
  -> creatorcut-server (private Director strategy)
  -> agentmesh-core (identity, entitlements, price and credits)

CreatorCut is the internal Studio/dogfood source. creatorcut-server owns card orchestration, semantic editing policy, signed plan generation, and billing recovery. agentmesh-core remains the shared control plane and price source. This product does not depend on AgentMesh360-Client.

See System boundary for the data and trust model.

Development

Requirements:

• Node 24
• pnpm 10

pnpm install
pnpm verify
pnpm protocol:digest
pnpm pack:protocol

pnpm protocol:digest prints the stable digest that private consumers must pin. pnpm pack:protocol builds the independently consumable protocol tarball used by private services during this pre-release phase.

After a source build, the development CLI can be invoked with Node 24:

node apps/cli/dist/src/main.js doctor

The local-only media path is available for development verification:

node apps/cli/dist/src/main.js media import \
  --project /path/to/demo.creatorcut \
  --source /path/to/recording.mov

node apps/cli/dist/src/main.js transcribe start \
  --project /path/to/demo.creatorcut \
  --model /path/to/ggml-model.bin \
  --language mixed

node apps/cli/dist/src/main.js export start \
  --project /path/to/demo.creatorcut \
  --output /path/to/demo.mp4

zh, en, auto, and mixed transcription modes are supported. The mixed mode runs local auto, Chinese, and English candidates and selects the best bilingual result. Local editing keeps original audio unless a signed Manifest explicitly requests a supported change. Applying a signed Manifest requires the exact confirmation token returned by edit preview; exporting never overwrites an existing file unless --confirm-overwrite is present.

Remote Director commands intentionally require an AgentMesh API key stored by creatorcut auth login in macOS Keychain, Windows DPAPI, or Linux Secret Service; a trusted recovery-root-signed Director keyset; an explicit endpoint, and the pinned protocol bundle digest. The repository does not ship staging credentials or silently select a production endpoint.

See Agent onboarding, privacy contract, and managed release policy. Exact Cycle 4 scope and verification are recorded in Cycle 4 closeout evidence.

License

Apache-2.0. See LICENSE.