PEAKIQ - Software Solutions & Digital Innovation Peakiq Software Development

Peakiq Blog

Enable Terminal Suggestions in VSCode: Boost Developer Productivity

Boost your developer productivity by enabling VSCode's terminal IntelliSense. Learn to configure auto-suggestions for commands, file paths, and git branches.

Editorial4 min read695 words
Enable Terminal Suggestions in VSCode: Boost Developer Productivity

Unlock VSCode Terminal IntelliSense

Requires: VSCode 1.90+ · Shell Integration enabled

Your terminal just got smarter. VSCode's integrated terminal now ships with context-aware IntelliSense — auto-suggestions for commands, file paths, git branches, npm packages, and CLI arguments, all as you type. It's one setting flip away.


What You Get

Once enabled, the terminal becomes genuinely intelligent:

WorkflowBeforeAfter
Switch git branchType full branch namegit co → Tab through branches
Navigate dirsType full pathcd src/com → Tab-complete
Install packagesRemember package namenpm i → Suggestions from package.json
Recall commands↑ scroll through historyCtrl+Alt+R smart history picker

Quick Enable

Follow these four steps to activate terminal suggestions immediately:

  1. Open VSCode Settings — Press Ctrl+, (Windows/Linux) or Cmd+, (macOS).
  2. Search for the setting — Type terminal integrated suggest in the search bar.
  3. Enable the toggle — Check Terminal › Integrated: Suggest: Enabled.
  4. Restart your terminal — Open a new terminal with Ctrl+Shift+` or run Developer: Reload Window.

Tip: You can also add "terminal.integrated.suggest.enabled": true directly to your settings.json for instant effect.


Advanced Configuration

Fine-tune the behavior with these settings in your settings.json:

{
  "terminal.integrated.suggest.enabled": true,
  "terminal.integrated.suggest.quickSuggestions": true,
  "terminal.integrated.suggest.suggestOnTriggerCharacters": true,
  "terminal.integrated.suggest.selectionMode": "insertItem"
}

What each option does:

  • quickSuggestions — Auto-shows suggestions based on what you've typed, no manual trigger needed.
  • suggestOnTriggerCharacters — Fires on -, /, and Space — key moments in command building.
  • selectionMode: "insertItem" — Tab inserts the suggestion inline. Use "selectItem" to fully replace the token.
  • runOnEnter — Execute the accepted suggestion immediately with Enter, not just Tab.
  • upArrowNavigatesHistory — Set false to use ↑ for shell history instead of cycling the suggestion list.

Shell Integration Setup

Terminal IntelliSense depends on shell integration — VSCode's mechanism for detecting command boundaries and exit codes. Without it, suggestions are limited.

Automatic (Recommended)

Shell integration activates automatically for bash, zsh, fish, pwsh, and Git Bash when launched from VSCode. Ensure this is enabled:

{
  "terminal.integrated.shellIntegration.enabled": true
}

Verify: Hover over a terminal tab. If it shows "Rich", shell integration is fully active and IntelliSense is at maximum capability.

Manual (for complex setups)

For custom dotfiles, remote environments, or niche shells, inject the integration script manually.

bash / zsh — add to ~/.bashrc or ~/.zshrc:

[[ "$TERM_PROGRAM" == "vscode" ]] && \
  . "$(code --locate-shell-integration-path bash)"

fish — add to ~/.config/fish/config.fish:

string match -q "$TERM_PROGRAM" "vscode"
and . (code --locate-shell-integration-path fish)

PowerShell — add to $PROFILE:

if ($env:TERM_PROGRAM -eq "vscode") {
  . "$(code --locate-shell-integration-path pwsh)"
}

Power Workflows

Once active, these patterns become second nature:

Git branch navigation

git checkout   # Tab → shows all local/remote branches
git co feat    # Tab → filters to branches starting with "feat"

Directory traversal

cd src/comp    # Tab → completes to src/components/
ls ../con      # Tab → resolves relative paths instantly

npm workflows

npm run        # Tab → lists scripts from package.json
npm install r  # Tab → suggests installed packages matching "r"

Keyboard shortcuts

ShortcutAction
TabAccept suggestion
Ctrl+SpaceForce-open suggestions anywhere
Ctrl+Alt+RSmart history picker with fuzzy search

Troubleshooting

No suggestions appearing?

  1. Confirm terminal.integrated.suggest.enabled is true.
  2. Hover the terminal tab — it must show "Rich", not "Basic".
  3. Run Terminal: Clear Suggest Cached Globals from the Command Palette.
  4. Reload: Ctrl+Shift+PDeveloper: Reload Window.

Suggestions are wrong or stale?

  • Run Terminal: Clear Suggest Cached Globals to wipe the index.
  • Check for conflicting completions in your ~/.bashrc or ~/.zshrc.

Shell integration not activating?

  • Make sure the terminal is launched from VSCode, not attached externally.
  • For WSL, SSH, or Dev Containers, use the manual script injection above.
  • Minimum versions: VSCode 1.77+ for shell integration, 1.90+ for IntelliSense.

Windows + Git Bash: Verify Git is on your PATH. Run code --locate-shell-integration-path bash in an external terminal to confirm the path resolves correctly.


Summary

VSCode Terminal IntelliSense is a low-friction, high-impact upgrade. One setting, one restart, and your terminal starts completing branches, paths, and package names the way your editor already does for code.

Enable it, confirm shell integration shows Rich, and let Tab do more of the work.