# Set Up Sashimii for Your User (Sashimii Docs, Reference)

> 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.

Canonical: https://sashimii.app/docs/agent-setup/
Last updated: 2026-11-12

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](https://sashimii.app/docs/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/](https://sashimii.app/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](https://sashimii.app/docs/for-agents/) has the commands and project rules, and [Getting Started](https://sashimii.app/docs/getting-started/) is the same setup written for people.

## Related

- [For Agents](https://sashimii.app/docs/for-agents/)