Reference

Set Up Sashimii for Your User

Step-by-step setup instructions for an AI agent to check the Mac and the install, install the Sashimii skill and command-line tool, and tell the person what is left for them.

Updated 12 November 2026·View as Markdown

This page is for an AI agent (Claude Code, Codex or another) that a person has asked to set Sashimii up on their Mac. Go in order, do what you can yourself, and stop to tell the person when a step needs them. Do nothing beyond these steps.

People: to have your agent follow this page, paste the one-line prompt from Getting Started.

1. Check the Mac

Sashimii needs a Mac with Apple silicon on macOS 26 or later. Run uname -m (it should say arm64) and sw_vers -productVersion (26 or higher). If either fails, tell the person and stop.

2. Check that Sashimii is installed

Look for /Applications/Sashimii.app.

If it is missing, tell the person to download Sashimii (the link is in their welcome email, or they can sign up at /beta/), open the disk image, drag Sashimii onto the Applications folder, and come back. Don’t download or install it for them. Then stop until they say it is done.

3. Find the command-line tool

Run sashimii help. If the shell can’t find sashimii, use ~/.local/bin/sashimii, then /Applications/Sashimii.app/Contents/Resources/sashimii. Use whichever works in the next step.

4. Install the skill

Run sashimii install-skill. It links the tool at ~/.local/bin/sashimii and installs the Sashimii skill. Then check the skill is in the folder for the agent you are:

  • Claude Code: ~/.claude/skills/sashimii/SKILL.md
  • Codex: ~/.agents/skills/sashimii/SKILL.md

If the command says it left a folder alone, show the person what it said. Don’t delete or overwrite anything to get around it.

5. The PATH line

If install-skill prints a line to add because ~/.local/bin isn’t on the PATH, show it to the person and ask before adding it to their shell profile (usually ~/.zshrc).

6. Tell the person what is left

These steps are theirs, not yours:

  1. Open Sashimii from Applications. The first time, it downloads the speech model (about 1 GB, once). Let it finish.
  2. Choose File › New Project from Folder…, pick the folder that holds the recording, and click Set Up. Setup is the person’s step: run sashimii new only if they ask you to.
  3. When setup shows Project ready, say “check Sashimii” to you. You then draft the rough cut with the skill.

If your skill list doesn’t show sashimii yet, tell the person to restart you first.

What not to do

  • Don’t download or install the app.
  • Don’t delete or overwrite an existing skill folder or tool link.
  • Don’t change the shell profile without asking.
  • Don’t connect Sashimii to your agent (sashimii register) unless the person asks. It isn’t needed for a first draft.

When you finish, say in a few lines what you found, what you did and what is left for the person.

More: For Agents has the commands and project rules, and Getting Started is the same setup written for people.