terminaI
Install
Docs track: Current (v0.1). Versioned docs planned.

TerminaI settings (`/settings` command)

Control your TerminaI experience with the /settings command. The /settings command opens a dialog to view and edit all your TerminaI settings, including your UI experience, keybindings, and accessibility features.

Your TerminaI settings are stored in a settings.json file. In addition to using the /settings command, you can also edit them in one of the following locations:

  • User settings: ~/.terminai/settings.json
  • Workspace settings: your-project/.gemini/settings.json

Note: Workspace settings override user settings.

Settings reference

Here is a list of all the available settings, grouped by category and ordered as they appear in the UI.

General

UI Label

Setting

Description

Default

Preview Features (e.g., models)

general.previewFeatures

Enable preview features (e.g., preview models).

false

Vim Mode

general.vimMode

Enable Vim keybindings.

false

Disable Auto Update

general.disableAutoUpdate

Disable automatic updates.

false

Enable Prompt Completion

general.enablePromptCompletion

Enable AI-powered prompt completion suggestions while typing.

false

Debug Keystroke Logging

general.debugKeystrokeLogging

Enable debug logging of keystrokes to the console.

false

Session Retention

general.sessionRetention

Settings for automatic session cleanup. This feature is disabled by default.

undefined

Enable Session Cleanup

general.sessionRetention.enabled

Enable automatic session cleanup.

false

Output

UI Label

Setting

Description

Default

Output Format

output.format

The format of the CLI output. Can be text or json.

text

UI

UI Label

Setting

Description

Default

Hide Window Title

ui.hideWindowTitle

Hide the window title bar.

false

Show Status in Title

ui.showStatusInTitle

Show TerminaI status and thoughts in the terminal window title.

false

Hide Tips

ui.hideTips

Hide helpful tips in the UI.

false

Hide Banner

ui.hideBanner

Hide the application banner.

false

Hide Context Summary

ui.hideContextSummary

Hide the context summary (GEMINI.md, MCP servers) above the input.

false

Hide CWD

ui.footer.hideCWD

Hide the current working directory path in the footer.

false

Hide Sandbox Status

ui.footer.hideSandboxStatus

Hide the sandbox status indicator in the footer.

false

Hide Model Info

ui.footer.hideModelInfo

Hide the model name and context usage in the footer.

false

Hide Context Window Percentage

ui.footer.hideContextPercentage

Hides the context window remaining percentage.

true

Hide Footer

ui.hideFooter

Hide the footer from the UI.

false

Show Memory Usage

ui.showMemoryUsage

Display memory usage information in the UI.

false

Show Line Numbers

ui.showLineNumbers

Show line numbers in the chat.

false

Show Citations

ui.showCitations

Show citations for generated text in the chat.

false

Use Full Width

ui.useFullWidth

Use the entire width of the terminal for output.

true

Use Alternate Screen Buffer

ui.useAlternateBuffer

Use an alternate screen buffer for the UI, preserving shell history.

true

Disable Loading Phrases

ui.accessibility.disableLoadingPhrases

Disable loading phrases for accessibility.

false

Screen Reader Mode

ui.accessibility.screenReader

Render output in plain-text to be more screen reader accessible.

false

IDE

UI Label

Setting

Description

Default

IDE Mode

ide.enabled

Enable IDE integration mode.

false

Model

UI Label

Setting

Description

Default

Max Session Turns

model.maxSessionTurns

Maximum number of user/model/tool turns to keep in a session. -1 means unlimited.

-1

Compression Threshold

model.compressionThreshold

The fraction of context usage at which to trigger context compression (e.g. 0.2, 0.3).

0.2

Skip Next Speaker Check

model.skipNextSpeakerCheck

Skip the next speaker check.

true

Context

UI Label

Setting

Description

Default

Memory Discovery Max Dirs

context.discoveryMaxDirs

Maximum number of directories to search for memory.

200

Load Memory From Include Directories

context.loadMemoryFromIncludeDirectories

Controls how /memory refresh loads GEMINI.md files. When true, include directories are scanned; when false, only the current directory is used.

false

Respect .gitignore

context.fileFiltering.respectGitIgnore

Respect .gitignore files when searching.

true

Respect .geminiignore

context.fileFiltering.respectGeminiIgnore

Respect .geminiignore files when searching.

true

Enable Recursive File Search

context.fileFiltering.enableRecursiveFileSearch

Enable recursive file search functionality when completing @ references in the prompt.

true

Disable Fuzzy Search

context.fileFiltering.disableFuzzySearch

Disable fuzzy search when searching for files.

false

Tools

UI Label

Setting

Description

Default

Enable Interactive Shell

tools.shell.enableInteractiveShell

Use node-pty for an interactive shell experience. Fallback to child_process still applies.

true

Show Color

tools.shell.showColor

Show color in shell output.

false

Auto Accept

tools.autoAccept

Automatically accept and execute tool calls that are considered safe (e.g., read-only operations).

false

Use Ripgrep

tools.useRipgrep

Use ripgrep for file content search instead of the fallback implementation. Provides faster search performance.

true

Enable Tool Output Truncation

tools.enableToolOutputTruncation

Enable truncation of large tool outputs.

true

Tool Output Truncation Threshold

tools.truncateToolOutputThreshold

Truncate tool output if it is larger than this many characters. Set to -1 to disable.

10000

Tool Output Truncation Lines

tools.truncateToolOutputLines

The number of lines to keep when truncating tool output.

100

Enable Message Bus Integration

tools.enableMessageBusIntegration

Enable policy-based tool confirmation via message bus integration.

true

Security

UI Label

Setting

Description

Default

Disable YOLO Mode

security.disableYoloMode

Disable YOLO mode, even if enabled by a flag.

false

Blocks extensions from Git

security.blockGitExtensions

Blocks installing and loading extensions from Git.

false

Folder Trust

security.folderTrust.enabled

Setting to track whether Folder trust is enabled.

false

Allowed Environment Variables

security.environmentVariableRedaction.allowed

Environment variables to always allow (bypass redaction).

[]

Blocked Environment Variables

security.environmentVariableRedaction.blocked

Environment variables to always redact.

[]

Experimental

UI Label

Setting

Description

Default

Enable Codebase Investigator

experimental.codebaseInvestigatorSettings.enabled

Enable the Codebase Investigator agent.

true

Codebase Investigator Max Num Turns

experimental.codebaseInvestigatorSettings.maxNumTurns

Maximum number of turns for the Codebase Investigator agent.

10

Previous
Session Management
Next
Telemetry