yasp

The interactive AI shell. Wraps Claude Code with the bundled yasp plugin (skills, hooks, permissions) and a generated session name.

yasp                      # launch a new session in the current directory

See Compile your first model for installation and a walk-through of the first launch. This page is the flag reference.

Options

Flag	Description
--agent <name>	Shell agent to launch. Defaults to claude.
--name <name>	Session display name (default: yasp-<cwd-slug>-<timestamp>). Mutually exclusive with --resume.
--resume [<id-or-name>]	Resume a session by ID or name. Mutually exclusive with --name.
--list[=<filter>]	List resumable sessions in the current directory (see below).
--no-bundled-skills	Launch without the yasp plugin (skills, hooks, permissions).
--install-completion	Install shell completion so --resume <TAB> cycles through session names.

Listing and resuming sessions

yasp --list              # sessions started via yasp from this directory
yasp --list=all          # every session in this directory, including plain `claude` ones
yasp --list=feature-x    # substring-match name or AI-generated title

Each row shows the session name, the AI-generated title, the git branch, when it was last active, and which agent it belongs to. When a session exits, yasp prints a copy-pasteable yasp --resume "..." line.

Pass-through flags

Arguments after a -- separator are forwarded verbatim to Claude Code:

yasp -- -c                # continue the most recent conversation
yasp -- --model sonnet    # pick a different model