Terminals · VS Code, Cursor, Windsurf, Kiro, Trae, Positron
VS Code and Cursor terminal autocomplete on Mac
Last checked 19 November 2026
In short: VS Code has its own terminal suggestions (terminal IntelliSense). Cursor's terminal docs cover running commands for its agent, not a completion menu. Termhint adds a zsh autocomplete popup to the integrated terminal of VS Code (Insiders too) and the editors built on it: Cursor, Windsurf, VSCodium, Kiro, Trae and Positron. It needs the Accessibility permission and one editor setting.
Set up terminal autocomplete in VS Code, Cursor or Windsurf
- Download Termhint, move it to Applications and open it. On launch it adds one marked block to
~/.zshrc, backed up first. - Allow Termhint in System Settings → Privacy & Security → Accessibility. Termhint shows macOS's prompt on first launch, and notices the change without a restart (permissions).
- Open a new tab. Tabs that were open before Termhint set up zsh don't have it yet.
- Type
git ch. The popup opens under the cursor; Tab, the arrows, Esc and Enter go to it only while it is open. - In the editor's
settings.json, set"editor.accessibilitySupport": "off". Termhint turns on Electron's accessibility tree to find the terminal cursor, and this setting keeps the editor from switching to screen-reader mode.
VS Code terminal IntelliSense
VS Code's docs describe terminal IntelliSense that gives "suggestions for files, folders, commands, command arguments and options", shown as you type or with Ctrl+Space, and turned on or off with terminal.integrated.suggest.enabled (VS Code terminal shell integration docs). If it covers what you need, you don't need Termhint in VS Code.
If you use Termhint there, turn VS Code's suggestions off with "terminal.integrated.suggest.enabled": false so you don't get two popups. What Termhint adds: the same popup in VS Code, Cursor, Windsurf and your other terminals, Fig's completion specs plus zsh's completion functions and man page options, and dynamic suggestions such as the scripts in your package.json for npm run, yarn, pnpm and bun.
Cursor terminal autocomplete
Cursor's terminal docs are about its agent: Cursor "runs shell commands directly in your terminal", with run modes and a sandbox deciding what runs (Cursor terminal docs), and its help adds generating commands from natural language (Cursor terminal help). Neither page describes a completion menu for commands and options. Termhint's popup works in Cursor's integrated terminal like in VS Code, with the same editor.accessibilitySupport setting. Cursor's docs also suggest skipping heavy prompts such as Powerlevel10k when its agent runs; Termhint's prompt themes are drawn by the shell without a process per prompt.
Windsurf
windsurf.com now leads to Devin Desktop (announcement). Its terminal docs describe a Command mode (Cmd+I) that writes CLI syntax from a prompt in natural language, and agent-run commands under permission rules (Devin Desktop terminal docs); no completion menu for commands and options. Termhint recognizes Windsurf by its app identifier. An app it doesn't recognize is tried with Accessibility first, then the cursor cell.
Kiro, Trae, Positron and VSCodium
Kiro, Trae and Positron are built on VS Code, and Termhint treats their integrated terminal the same way: it turns on Electron's accessibility tree to find the cursor, so they need Accessibility and "editor.accessibilitySupport": "off" in their settings.json too. Icons work as in VS Code: termhint icons on kiro (or trae, positron) adds a Nerd Font to their terminal font list. VSCodium works like VS Code. Kiro's separate command-line tool is a different product; Kiro CLI autocomplete compares it.
Examples in the integrated terminal
npm run,yarn,pnpmandbunlist the scripts in yourpackage.json.git checkoutlists branches such asmainandfeature/login; withalias gco='git checkout',gcodoes too (Git autocomplete).makelists the project's Makefile targets;sshlists hosts; Docker commands list containers and images.
Branches, hosts and containers are read by Termhint itself; it never runs git, ssh or docker for this. Completions come from bundled specs for 3,272 commands, zsh's completion functions and man pages.
What else Termhint sets in these editors
- Icons:
termhint icons on cursor(orvscode,windsurf,kiro,trae,positron) puts a Nerd Font first interminal.integrated.fontFamily, keeping the rest of the list and the comments in settings.json;icons offputs it back. Open a new terminal tab to see it. - Colors, prompt themes and tab titles, set by the shell in the integrated terminal.
Limits
- The popup needs Accessibility in these editors.
- zsh only, Apple silicon, macOS 14 or later. Inside tmux it works; not inside GNU screen.
- No completion specs you write yourself.
Not working?
- No popup in VS Code, Cursor, Kiro, Trae or Positron: check Accessibility for Termhint and
editor.accessibilitySupport. Two popups: turn offterminal.integrated.suggest.enabled. - The panel under Termhint's menu-bar icon shows whether autocomplete is on, the one step left if it is not, and the terminal tabs connected.
- Your shell must be zsh. bash gets prompt themes and colors, no popup.
- Esc hides the popup until the line changes.
More fixes: terminal autocomplete not working and troubleshooting. Using a JetBrains IDE or Zed too? See JetBrains IDEs and Zed.