WispTerm

Built for daily work

WispTerm layers practical features on top of Ghostty's terminal core — splits, tabs, AI agent tools, a file explorer, themes, background images, and an opt-in remote-access client.

Configure with a single file

WispTerm uses a Ghostty-compatible key = value config. Default path: %APPDATA%\wispterm\config on Windows, ~/Library/Application Support/wispterm/config on macOS. Press Ctrl+, (Cmd+, on macOS) to open it; CLI flags override file values.

font-family            = Cascadia Code
font-size              = 14
cursor-style           = bar
cursor-style-blink     = true
theme                  = Poimandres

window-width           = 120
window-height          = 32
scrollback-limit       = 10000000

custom-shader          = path\to\shader.glsl
background-image       = C:\Users\me\Pictures\wallpaper.png
background-opacity     = 0.85
background-image-mode  = fill

# Opt-in remote access (disabled by default)
remote-enabled         = false
remote-server-url      = https://remote.example.com
remote-device-name     = Workstation
remote-session-key     = Workstation

# AI Chat agent tools
ai-agent-enabled       = true
ai-agent-permission    = ask       # ask | auto | full
ai-agent-output-limit  = 16384

Run wispterm --help for the full flag list, or wispterm --show-config-path to print the resolved config path.

SSH downloads & uploads that follow your current directory

WispTerm can download a relative file path from SSH terminal output, and upload dragged files into the interactive SSH shell's current directory — but only when the remote shell reports that directory with OSC 7, the same terminal convention Ghostty's shell integration uses.

When OSC 7 is missing, the helper ssh.exe / scp.exe commands open a fresh session that usually sees the login directory, not the directory you cd'd to. In that case WispTerm shows “SSH cwd unknown; click for setup” instead of guessing ~/file.

Add one of these snippets to the remote shell's startup file, then start a new WispTerm SSH session.

__wispterm_report_cwd() {
  printf '\033]7;file://%s%s\a' "${HOSTNAME:-localhost}" "$PWD"
}
PROMPT_COMMAND="__wispterm_report_cwd${PROMPT_COMMAND:+;$PROMPT_COMMAND}"

__wispterm_report_cwd() {
  printf '\033]7;file://%s%s\a' "${HOST:-localhost}" "$PWD"
}
autoload -Uz add-zsh-hook
add-zsh-hook chpwd __wispterm_report_cwd
add-zsh-hook precmd __wispterm_report_cwd

function __wispterm_report_cwd --on-variable PWD
    printf '\e]7;file://%s%s\a' (hostname) (string escape --style=url $PWD)
end
__wispterm_report_cwd

FAQ