Docs / Reference
Settings
Every Tezgah setting, from appearance and language to the default terminal, updates, notifications and Claude's tools.
Open Settings with ⌘, (Ctrl+,) or the gear at the top of the sidebar.
Appearance
- Theme: Light, Dark, or follow the System.
- Language: Türkçe or English, or follow the system language.
- Terminal font size.
- Terminal look: use the font and colors from your Ghostty config, if you have one.
Claude
- Claude arguments are added every time a session starts Claude Code, for example
--model opus. - Browser and pane tools for Claude gives Claude sessions the browser tools. On by default.
Commands
Your own commands, one per line as Name: command. See Custom commands.
Plan limits in the sidebar
Show or hide the Claude and Codex limits at the bottom of the sidebar. Codex’s show while Codex is signed in or was used this week. See Plan limits & usage.
Notifications
Whether to notify you when an agent needs you or finishes while you’re elsewhere.
Default terminal
Make Tezgah the terminal your desktop opens:
- macOS: Tezgah opens shell scripts (
.command,.sh) andssh://links. Folders open with Tezgah from Finder’s Open With. - Linux: Tezgah becomes GNOME’s terminal and takes
-e/-xcommands like other terminals. - Windows keeps its own default terminal setting for itself. Right-click a folder and choose Open in Tezgah instead.
Opening a folder starts
When you open a folder from Finder, Explorer, your file manager or the command line: start Claude or a shell.
Updates
- Check for updates looks for a newer Tezgah on GitHub at launch and every six hours.
- Install updates downloads a new version in the background and puts it in place when you quit Tezgah; Restart in the sidebar installs it right away. For the macOS app, the Windows installer and AppImages; a
.deblinks the release instead.
Keyboard Shortcuts
Change any shortcut. See Keyboard shortcuts.
Introduction
Show Again replays the short tour shown on first launch.