# Sashimii Docs

> How to set up a recording in Sashimii, get a first draft from your agent, review the cut and export it.

Canonical: https://sashimii.app/docs/
Last updated: 2026-11-02

Sashimii is a Mac app for rough cuts of spoken recordings: talking-head video, or audio on its own. It splits the work in two:

- **The transcript decides what is cut.** Your AI agent (Claude Code or Codex) reads the transcript and picks the takes, using the Sashimii skill and command-line tool.
- **The waveform decides where.** Sashimii moves every cut edge onto the audio, so joins land between words, not inside them.

Then you review the cut in Sashimii: step through every join, fix any edge to the frame, leave notes for your agent, and export a video file or an editable timeline for DaVinci Resolve.

## The Short Version

1. Choose **File › New Project from Folder…** and pick the folder with your recording. Sashimii transcribes it on your Mac.
2. In Claude Code or Codex, type `check Sashimii`. Your agent drafts the cut.
3. Open the project, press <kbd>R</kbd> and review each join.
4. Press <kbd>⌘</kbd> <kbd>E</kbd> to export.

New to Sashimii? Start with [Getting Started](https://sashimii.app/docs/getting-started/).

## For AI Agents

Every page here has a Markdown version: add `.md` to its URL (this page is [/docs.md](https://sashimii.app/docs.md)). [/llms.txt](https://sashimii.app/llms.txt) lists them all, and [/llms-full.txt](https://sashimii.app/llms-full.txt) has every page in one file. If you are an agent helping someone use Sashimii, read [For Agents](https://sashimii.app/docs/for-agents/) first.

## Start Here

- [From the Download to Your First Rough Cut](https://sashimii.app/docs/getting-started/): Install Sashimii, set up your first project and get your agent's first rough cut.
- [Setting Up a Project](https://sashimii.app/docs/projects/): Turn a folder holding your recording into a Sashimii project, with a separate recorder file, a Style and voice cleanup if you want them.
- [Drafting with Your Agent](https://sashimii.app/docs/drafting-with-your-agent/): How your AI agent drafts the rough cut with the Sashimii skill, what it changes, and how to connect it so it starts by itself.

## Editing

- [Finding Your Way Around](https://sashimii.app/docs/the-window/): The parts of a Sashimii project window, the Source, Cut and Edit views, and how to play, move the playhead and zoom the timeline.
- [Cutting and Restoring Words](https://sashimii.app/docs/cutting/): Cut and restore words from the transcript or the timeline, answer the pauses and cuts Sashimii flagged, and move a cut edge by hand.
- [Reviewing Joins](https://sashimii.app/docs/reviewing-joins/): Step through every join in the cut at frame zoom, listen across it, fix its edges and accept it.
- [Notes and Directions](https://sashimii.app/docs/notes/): Leave notes on words or ranges, tag them with what should happen there, and hand them to your agent through the agent queue.
- [Edit View and Graphics](https://sashimii.app/docs/edit-view-and-graphics/): Watch the cut as one continuous timeline, adjust joins from it, and move, retime, approve or send back the graphics your agent made.
- [Voice Cleanup](https://sashimii.app/docs/voice-cleanup/): Clean up background noise and room echo in your voice, preview the result against the original, and choose how much to apply.

## Finishing

- [Exporting](https://sashimii.app/docs/exporting/): Render the cut as an MP4, export it to DaVinci Resolve as an editable timeline on your original footage, or write an audio project's cut as a WAV.
- [YouTube Chapters](https://sashimii.app/docs/chapters/): Mark chapters while you review by tagging notes, see them in Edit view, and copy the chapter list for your YouTube description.
- [Styles](https://sashimii.app/docs/styles/): Make a visual Style for your graphics by picking from options your agent shows over your own footage, then use it in every project.
- [Audio Projects and Voiceover Videos](https://sashimii.app/docs/audio-and-voiceover/): Cut a podcast, lesson or other audio-only recording, export it as a WAV, or turn it into a voiceover video with graphics.

## Reference

- [Keyboard Shortcuts](https://sashimii.app/docs/keyboard-shortcuts/): The keyboard shortcuts in Sashimii, for playback, cutting, join review, notes, graphics and export.
- [For Agents](https://sashimii.app/docs/for-agents/): What an AI agent needs to help someone with Sashimii, the skill, the sashimii command-line tool, the project files, and the rules for changing them.

## Related

- [From the Download to Your First Rough Cut](https://sashimii.app/docs/getting-started/)