Documentation
Settings & Preferences
Every option in Typilot is documented here with plain-language explanations and recommended defaults.
⚙️ Changes are safe to explore—you can always use “Reset to defaults” in the app to go back • Settings apply instantly after you click Save
Connection & Models
Tell Typilot where to find Ollama and which model to use by default. The app automatically refreshes the model list when Ollama is online.
Ollama URL
Usually localhost:11434. Change this if you run Ollama on another machine or expose it over the network.
Default model
Choose from locally downloaded models. Typilot reminds you to restart services when you switch so the new model loads immediately.
Shortcut keys
Customise how you send, cancel, and activate Typilot anywhere on your desktop. All changes apply instantly once you hit save.
Send request key
Default is the period key (.) so you can press it with your right hand while keeping the left on modifiers. Pick any key that suits you.
Cancel request key
Set a dedicated key (Esc by default) to stop streaming responses immediately.
Keyboard layout
Needed on Linux/Wayland so Typilot types the right characters for your locale. Choose from popular layouts including DE, FR, ES, JP, and more.
Manual device detection
Press “Detect Keyboard” to capture the exact /dev/input path when Wayland picks an unusual device. Typilot stores it for future launches.
Quick activation shortcut
Define a global modifier + key combination that instantly inserts your favourite command (like gen:) so you can start typing without lifting your hands.
Modifier key
Choose Ctrl, Cmd, Alt, or Shift. Typilot validates the choice and guides you if you press an unsupported key.
Main key
Pick Space or any letter (A–Z). The UI shows a live preview such as Ctrl+Space so you always know the combo.
Activation command
Select whichever prompt should auto-fill after the shortcut runs. Leave it blank if you prefer to type commands manually.
Mouse safe zone
Control how Typilot responds when you click the mouse while a response is streaming.
Full screen mode
Disable mouse cancellation entirely so you can click anywhere without stopping the response.
Safe zone size
When full screen mode is off, adjust the horizontal and vertical range (in pixels) around the cursor that keeps Typilot running.
Screenshot capture (img:)
Configure how Typilot captures your screen when you run the img: command with a vision-enabled model.
Full screen
Capture the entire display—perfect for describing complex layouts or multi-window screenshots.
Capture region
Set width and height for the focused region around your cursor. Smaller regions keep OCR crisp and responses faster.
AI behaviour
Fine-tune how Typilot streams responses back to you.
Think mode
Enable to see the model’s intermediate reasoning steps. Useful for debugging or learning but slightly slower.
Typing speed
Adjust the delay between tokens (1–100 ms). Lower values feel instant; higher values provide a “human typing” effect.
System preferences
Decide how Typilot behaves when your computer starts up or when it runs in the background.
Start on startup
Keep Typilot ready the moment you log in. Disable it on low-resource systems or if you only use Typilot occasionally.
Minimise to tray
Hide the window but keep services running. You can reopen Typilot from the tray icon whenever you need it.
Hints & sounds
Toggle on-screen hints and sound cues when requests start or stop. Wayland users see a notice that the hint overlay is unavailable.
Data retention
Let Typilot keep only the history and logs you really need.
Auto-cleanup
Enable scheduled deletion of history and log entries. Perfect for shared machines or privacy-conscious workflows.
History retention days
Choose how many days of command history to store (1–365).
Log retention days
Specify how long to keep diagnostic logs (1–90 days).
License status tile
The top-left tile in Settings shows whether your license is active, in a grace period, or needs attention. Click “Check again” to revalidate immediately or “Manage account” to open the web dashboard.
Danger zone
Need a fresh start? The “Delete all data” button removes history, logs, prompts, and configuration. Typilot restarts automatically afterwards. Export anything important first—there is no undo.