CLI
Claude-style flags:
sh
tapioca # new session in the current directory
tapioca -c # continue the most recent session
tapioca -r # pick a session to resume
tapioca -r 20260806-135204 # resume a specific session
tapioca --fork-session -c # continue, but into a new session id
tapioca --model ollama:qwen3 # model for this run
tapioca --permission-mode plan # start in plan mode
tapioca --dangerously-skip-permissions # bypass all tool prompts
tapioca --sandbox # confine bash to the worktree (bubblewrap)
tapioca -p "fix the failing test" # headless: run one prompt, print, exit
tapioca -p "summarize" --output-format json --max-turns 5
tapioca --system-prompt "..." --append-system-prompt "..."
tapioca --settings alt.toml --mcp-config mcp.toml --add-dir ../lib
tapioca --list-sessions
tapioca --acp # serve ACP on stdio (editors launch this)| Flag | Effect |
|---|---|
-c | continue this directory's most recent session |
-r [id] | resume: picker with no argument, a specific session with one |
--fork-session | resume/continue into a new session id |
--model [provider:]name | model for this run (not persisted) |
--permission-mode mode | starting permission mode: plan, manual, auto, bypass |
--dangerously-skip-permissions | start in bypass — every tool call runs without asking |
--sandbox | run bash under bubblewrap; see Sandboxing |
-p "prompt" | headless: run one prompt, print the result, exit |
--output-format json | structured output for headless runs |
--max-turns n | cap agent turns in headless mode |
--system-prompt / --append-system-prompt | replace or extend the system prompt |
--settings file.toml | use an alternate config file |
--mcp-config file.toml | additional MCP server config |
--add-dir path | grant access to another directory tree |
--list-sessions | print saved sessions and exit |
--acp | serve the Agent Client Protocol on stdio |
Flags are runtime-only overrides — they never persist to the config file.
The working directory Tapioca is started from becomes the agent's working directory; /cd moves it later.