# CutZal

> CutZal Docs in English. CutZal is a local Mac editor for talking-head videos: AI proposes the cuts from the transcript and the person confirms them. AI agents edit CutZal projects with the cutzal command; start with CutZal for AI agents.

## User guide

- [Get started](https://cutzal.ai/docs/en/start.md): Install CutZal, open a video and follow one flow through transcription, cut review and your first export.
- [Review loop and AI cut grades](https://cutzal.ai/docs/en/review.md): The CutZal review loop. Check the cuts AI picked with their grade and reason from the keyboard, and bring back anything cut by mistake.
- [Transcription options](https://cutzal.ai/docs/en/transcription.md): Compare the ways to get a transcript in CutZal (subtitle import, CutZal credits, your own ElevenLabs key, free local transcription) and when money is spent.
- [Layout, B-roll and sound effects](https://cutzal.ai/docs/en/layout.md): Change how your camera and screen recording are laid out in CutZal, put images and B-roll on top, and add or create sound effects.
- [Export](https://cutzal.ai/docs/en/export.md): Export the finished video and subtitles from CutZal. Pick the quality and items to create, check the result and continue in another editor.
- [Chat and your agent](https://cutzal.ai/docs/en/chat.md): Connect your own Claude Code or Codex to CutZal chat and hand it edits. What it can do, what you confirm yourself, and terminal agents.
- [Original files and privacy](https://cutzal.ai/docs/en/files-and-privacy.md): How CutZal never changes your original videos, the files it makes in the edit folder next to your video, and what data leaves this Mac and when.

## Shortcuts

- [Keyboard shortcuts](https://cutzal.ai/docs/en/shortcuts.md): Every keyboard shortcut and mouse gesture in the CutZal editor, generated from the same table as the shortcut list in the app.

## AI agents

- [CutZal for AI agents](https://cutzal.ai/docs/en/agents/index.md): CutZal is a local desktop editor for talking-head videos. The cutzal command reads and edits one CutZal project at a time.
- [cutzal commands](https://cutzal.ai/docs/en/agents/commands.md): Every command prints one JSON object on stdout. Add --json to force JSON (the default when stdout is not a terminal) or --human for a short text summary.
- [Edit JSON](https://cutzal.ai/docs/en/agents/edits.md): preview and apply take one JSON object with exactly one key: range (cut or restore speech), speed (play parts faster or slower), track (tracks and clips),...
- [Output time and source time](https://cutzal.ai/docs/en/agents/coordinates.md): CutZal never changes the original recording. It keeps a list of the parts to keep, and the edited video plays those parts back to back.
- [Error codes](https://cutzal.ai/docs/en/agents/errors.md): A refusal looks like {"ok": false, "error": {"code": "...", "message": "...", "details": ...}} with exit code 2.