Skip to main content

Agents and Modes

Agents in Saarthi are specialized personas that tailor the assistant's behavior to your current task. Each mode offers different capabilities, expertise, and access levels to help you accomplish specific goals.

Sticky Models

Each agent or remembers your last-used model. When switching modes, Saarthi automatically selects that modelβ€”no manual selection needed. Assign different models to different modes (e.g., Gemini 2.5 Preview for πŸ—οΈ Architect mode, Claude Sonnet 3.7 for πŸ’» Code mode) and Saarthi will switch models automatically when you change modes.

Why Use Different Modes?​

  • Task specialization: Get precisely the type of assistance you need for your current task
  • Safety controls: Prevent unintended file modifications when focusing on planning or learning
  • Focused interactions: Receive responses optimized for your current activity
  • Workflow optimization: Seamlessly transition between planning, implementing, debugging, and learning

Switching Between Modes​

Four ways to switch modes:

  1. Dropdown menu: Click the selector to the left of the chat input

  2. Slash command: Type /<mode-name> in the chat input

  3. Toggle command/Keyboard shortcut: Use the keyboard shortcut below, applicable to your operating system. Each press cycles through the available modes in sequence, wrapping back to the first mode after reaching the end.

    Operating SystemShortcut
    macOS⌘ + .
    WindowsCtrl + .
    LinuxCtrl + .
  4. Accept suggestions: Click on mode switch suggestions that Saarthi offers when appropriate

Built-in Agents or Modes​

Customizing Modes​

Tailor Saarthi's behavior by customizing existing modes or creating new specialized assistants. Define tool access, file permissions, and behavior instructions to enforce team standards or create purpose-specific assistants. See Custom Modes documentation for setup instructions.