Add a terminal session to a recording

Start a terminal session

1. Start a recording of a display or a portion of the screen.
2. In your terminal, run shoyu terminal record. Shoyu wraps a new shell.
3. Work as usual. When you are done, type exit, or run shoyu terminal stop from another terminal.

To record a single command, put it after --:

shoyu terminal record --title "API server" -- npm run dev

The command’s exit code is passed back to you. If no recording is running, Shoyu opens the recorder and waits. It never starts a video by itself.

What is recorded

By default Shoyu records what the terminal prints, window resizes and the exit code. It hides likely secrets in the output before upload. It does not record what you type.

The session’s title comes from the shell or command and the folder name, never the full path. Use --title to set your own.

Record your keystrokes too

Add --capture-input to record your typing as well. The command warns you and asks you to type yes, and the Mac app asks you to allow it for this recording.

If it does not attach