Commands

Type / to open command search. TatsuCode commands control models, providers, sessions, display, permissions, and workflow features. 36 commands total in v0.9.107.

Quick Reference

Session & Project Commands

/new

/new
/new C:\Projects\my-app
/new ~/projects/backend-api

Starts a fresh session. If a path is provided, switches project too.

/session

Opens saved sessions for the active project.

/session-rename

/session-rename Feature: OAuth migration

Gives your current session a readable name.

/projects

Shows recent projects and lets you switch quickly.

Model & Provider Commands

/models

Opens model picker with filtering and provider grouping.

/models-add

Add models to your available list.

/models-taskagents

Assign a different model to each parallel sub-agent (Web, Code Explorer, Design Reviewer / Architect, YouTube Video, PDF Reader). Use cheaper / faster models for scout work and reserve stronger models for the main chat and review/design work. See Task Agents.

/connect (primary)

Open Provider Connections:

• OAuth subscriptions (OpenAI Plus/Pro, GitHub Copilot, Claude Agent / Claude Code)
• OpenRouter API key
• Custom/local providers
• Web search providers

/providers (alias)

Kept for compatibility; routes to the same provider UI as /connect.

Agent Skills & Plugins Commands

/skills

Browse and load skills into the current session.

/skills-refresh

Force skill re-discovery after editing or adding skill files.

/plugins

View and manage plugin connections (e.g., the built-in Unity Editor plugin).

/plugins-refresh

Re-scan plugin directories after install or update.

AI Behavior & Display Commands

/temperature or /temp

/temp 0.3
/temperature 0.7

Adjust response creativity.

/reason-effort

Adjust reasoning depth on supported models.

/reason-display

Toggle display of reasoning/scratch output.

/diff-view

Switch diff display mode (unified or side-by-side).

/theme

Open theme selector.

/sounds

Configure notification chimes for task-complete and permission/question events. Plays only when the TatsuCode window is unfocused. See Notifications.

Image Commands

/image-generation

Configure image-generation provider, model, and defaults (size, aspect ratio, quality, background). See Images.

/image-gallery

Open the unified image gallery — every image in your conversation and project, in one searchable view.

GPT-5.4+ Specific (OpenAI Direct)

These appear only when an OpenAI Direct GPT-5.4+ model is active:

/verbosity

Set response verbosity level.

/image-detail

Set image detail level (auto / low / high / native).

/native-search

Toggle GPT-5.4+'s native web search capability.

Usage & Context Commands

/usage

Shows token usage for the current session, including elapsed time per task and total work time.

/usage-quota

Shows quota/rate-limit data where provider APIs support it (including OpenRouter balance).

/compact

Manage context compaction:

• Auto compact toggle
• Compact now

Compaction is lossless for the conversation's purpose — tool calls and structured artifacts are preserved alongside a summarized transcript, with a separate continuity layer in session metadata. See Layered Memory.

System Commands

/init

Analyzes your repository and creates or updates AGENTS.md in your project root. Updates the project instructions layer of layered memory. User-global preferences and repo-local overrides are managed separately.

/permissions

Review, change, and grant individual tool permissions — permanently or for the current session. See Permissions and YOLO.

/yolo

Toggle YOLO mode — session-scoped permission bypass for power users. Hard system-protection guardrails stay on. First-time use shows an acknowledgement modal.

/add-tatsu

Add TatsuCode command launcher to user PATH.

/remove-tatsu

Remove launcher/path integration and optionally clean local app data.

/exit / /quit

Close TatsuCode (with confirmation).

Everyday Syntax Tips

File references with @

Explain @src/auth/service.ts
Compare @old-config.json and @new-config.json

The @ file picker is paginated and event-driven — it scales to 500k+ files without bridge-cap crashes or spinner flicker.

Image references with @img-NN

Take @img-03 and turn the sky into a sunset

Reference any image already in the conversation by its display ID.

Command completion

• Press Tab to autocomplete command names
• For argument commands like /new and /session-rename, Tab populates command text so you can continue typing arguments

Recommended Daily Workflow

1. /connect to verify provider status
2. /models to choose the right model
3. /models-taskagents once, to set up cost-efficient sub-agent models
4. /permissions to whitelist the tools you actually use
5. /skills when a specialized workflow is needed
6. /usage and /compact during long sessions

Next Steps

• AGENTS.md — project context file guide
• Layered Memory — global / project / local override tiers
• Agent Skills — full skills guide
• Providers — connection setup and troubleshooting
• Settings — personalization and AGENTS.md usage