Loading chapter

Download free

08 - REFERENCE

Settings &preferences.

Every option, with plain-language explanations and recommended defaults. Eight categories. Everything reversible.

01 Connection & models
02 Shortcut keys
03 Quick activation
04 Mouse safe zone
05 Screenshot capture (img:)
06 AI behavior
07 System preferences
08 Data retention

Connection & models

Pick the model Typilot uses. The bundled Ollama engine connects automatically; the list refreshes when it is online.

Ollama URL: Advanced. localhost:11434 (the bundled engine) by default. Point it at your own external Ollama instance if you run one.
Default model: Pick from locally downloaded models. Switching prompts a service restart.

Shortcut keys

Customize send, cancel, layout, and device detection. Changes apply on save.

Send key: Default . (period). Press it with your right hand while modifiers stay left.
Cancel key: Esc by default. Aborts streaming responses instantly.
Keyboard layout: Required on Linux/Wayland for correct character output. DE / FR / ES / JP and more.
Manual device detection: Capture exact /dev/input path when Wayland picks an unusual device.

Quick activation

Global combo that inserts your favorite command - type your idea, hit save.

Modifier: Ctrl, Cmd, Alt, or Shift. Validated as you press.
Main key: Space or any A–Z letter. Live preview shows the combo.
Activation command: Pre-fill a prefix (gen:, fix:…) or leave blank for manual entry.

Mouse safe zone

Control how Typilot reacts to mouse clicks during a streaming response.

Full screen mode: Disable mouse cancellation entirely.
Safe zone size: Pixel range around the cursor that keeps Typilot running.

Screenshot capture (img:)

How Typilot captures your screen for the img: command.

Full screen: Capture the entire display - best for whole-window context.
Capture region: Set width + height around the cursor. Smaller = faster, sharper OCR.

AI behavior

Fine-tune how the model streams responses.

Think mode: Show intermediate reasoning. Slower but useful for debugging and learning.
Typing speed: Delay between tokens (1–100 ms). Lower = instant; higher = human-typing rhythm.

System preferences

Startup, tray, and notification behavior.

Start on startup: Keep Typilot ready at login. Disable on low-spec systems.
Minimize to tray: Hide the window, keep services running. Reopen from the tray icon.
Hints & sounds: On-screen hints and sound cues. Hints unavailable on Wayland.

Data retention

Keep only the history and logs you actually need.

Auto-cleanup: Scheduled deletion of history and log entries.
History retention: 1–365 days of command history.
Log retention: 1–90 days of diagnostic logs.

DANGER ZONE

Delete all data wipes history, logs, prompts, and configuration, then restarts Typilot. There is no undo - export anything important first.

NEXT → 09 SETTING UP OLLAMA