Getting started

From the Download to Your First Rough Cut

Sashimii sets up your recording on your Mac, your agent drafts the cut, and you review it in Sashimii. This page walks through the first run.

What You Need

1. Install Sashimii

Open the disk image and drag Sashimii onto the Applications folder. Then open it from Applications.

If you open it straight from the disk image, the welcome window asks you to move it first: updates and the command-line tool don’t work from there.

2. The Welcome Window

The first time Sashimii opens, the welcome window shows three things to get done.

Speech Model

The download starts by itself. Sashimii transcribes on your Mac, so this is the only time it needs the model from the internet. If the download stops, click Try Again.

Install the Agent Skill

Click Install… to install two things your agent uses:

If ~/.local/bin isn’t on your PATH yet, the confirmation offers Copy PATH Line. Paste that line into your shell profile (usually ~/.zshrc).

You can run the same install later from the Sashimii menu: Install Command-Line Tool and Agent Skill… Run it again after an update to refresh the skill.

First Project

This one ticks itself off when you set up your first recording, below.

3. Set Up Your First Project

Choose File › New Project from Folder… (⌘ N), pick the folder that holds your recording, and click Set Up.

Nothing in the folder changes until setup finishes. Then the project is saved there, next to your recording, as a .sashimii file. Setup transcribes the recording and reads its waveform, and shows each step as it goes.

4. Tell Your Agent: Check Sashimii

When setup shows Project ready, go to your agent’s chat (Claude Code or Codex) and type:

check Sashimii

Your agent looks for projects waiting for a draft and starts on yours. If more than one is waiting, it asks which. When it’s done, open the project in Sashimii to review the cut.

No skill installed, or an agent that can’t use skills? Click Copy Request on the Project ready card and paste the request into your agent instead.

5. Optional: Connect Your Agent

You don’t need this for a first draft. A connected agent can wait while setup runs and start the moment it finishes, and Sashimii shows it as connected.

Updates, Feedback and Support

Updates arrive in the app. Sashimii checks for them on its own, and Sashimii › Check for Updates… checks right away.

Found a bug, have an idea or need help? Post it on sashimii.userjot.com.

Removing Sashimii

Sashimii can’t undo its own setup yet, so here is what to remove by hand. Run only the lines for the parts you installed.

Quit Sashimii, then move it from Applications to the Trash. Then remove the command-line tool and the skills:

rm -f ~/.local/bin/sashimii
rm -r ~/.claude/skills/sashimii
rm -r ~/.agents/skills/sashimii

If you connected Claude Code, remove the connection:

claude mcp remove --scope user sashimii

If you connected Codex, open ~/.codex/config.toml and delete the [mcp_servers.sashimii] table with the lines under it.

The speech model and app data are in these folders:

rm -r ~/Library/Application\ Support/Sashimii
rm -r ~/Library/Caches/Sashimii

Your projects stay where you made them, as .sashimii files next to your recordings. Styles you made are in ~/Documents/Sashimii/Styles. Delete those yourself if you don’t want them.