Skip to main content
Configure how Schaltwerk spawns terminal sessions in Settings → Terminal.

Shell Configuration

By default, Schaltwerk uses your system’s default shell ($SHELL). You can override this with a custom shell.

Shell Path

Set a custom shell executable path. Leave empty to use the system default. Examples:
  • /usr/local/bin/nu or /opt/homebrew/bin/nu (Nushell)
  • /usr/local/bin/fish or /opt/homebrew/bin/fish (Fish)
  • /bin/zsh or /usr/bin/zsh (Zsh)
  • /bin/bash or /usr/bin/bash (Bash)

Shell Arguments

Space-separated arguments passed to the shell. Leave empty for default interactive mode (-i).
Nushell doesn’t require the -i flag for interactive mode.
Changes apply to new terminals only. Existing terminals continue using their current shell.

Agent Command Prefix

Wrap all agent processes with a custom command. When you set a prefix, the agent command:
claude --dangerously-skip-permissions
becomes:
[prefix] claude --dangerously-skip-permissions
This applies to all agents (Claude, Codex, Gemini, etc.) across all sessions.

Use Cases

  • Remote Access - Set prefix to vt to use VibeTunnel for browser-based access
  • Custom Wrappers - Scripts for logging, environment setup, or resource management
The prefix applies to newly started agents. Existing running agents continue with their original command until restarted.