UnfoldAI Terminal

UnfoldAI includes a dedicated terminal profile that provides the most reliable command tracking and output capture. While UnfoldAI can monitor standard VS Code terminals, the UnfoldAI Terminal offers enhanced capabilities.

Opening the Terminal

Keyboard: Ctrl+Shift+U / Cmd+Shift+U — Open UnfoldAI Terminal
Keyboard: Ctrl+Shift+Alt+U / Cmd+Shift+Alt+U — New UnfoldAI Terminal instance
Command Palette: UnfoldAI: Open UnfoldAI Terminal or UnfoldAI: New UnfoldAI Terminal

Shell Support

Shell	Platform	Support
bash	macOS, Linux	✅ Full
zsh	macOS, Linux	✅ Full
fish	macOS, Linux	✅ Full
PowerShell / pwsh	Windows	✅ Full
cmd	Windows	⚠️ Basic (no shell integration hooks)

Features

Command Lifecycle Tracking

The UnfoldAI Terminal uses shell integration to precisely track command start, execution, output, and exit. This enables accurate command summaries, timing, and error detection.

Quick Actions

Three built-in quick actions available from the Command Palette:

Command	Description
`UnfoldAI: Copy Last Clean Output`	Copies the last command's output without terminal formatting noise
`UnfoldAI: Rerun Last Command`	Re-executes the most recent command
`UnfoldAI: Explain Last Error`	Opens a chat to analyze the last terminal error

Controlled by: unfoldai.terminal.quickActions.enabled (default: true)

Welcome Modes

Control the terminal greeting:

// settings.json
{
  // "auto" | "full" | "compact" | "hidden"
  "unfoldai.terminal.welcomeMode": "auto"
}

Completion Chips (Optional)

Show a status indicator after each command completion with exit code and duration:

{
  "unfoldai.terminal.completionChips.enabled": false
}

Command History Persistence (Optional)

Persist recent command history within your workspace:

{
  "unfoldai.terminal.historyPersistence.enabled": false,
  "unfoldai.terminal.historyPersistence.maxEntries": 120
}

Configuration Reference

Setting	Type	Default	Description
`unfoldai.terminal.welcomeMode`	enum	`"auto"`	Terminal welcome banner: auto, full, compact, hidden
`unfoldai.terminal.redrawMode`	enum	`"balanced"`	Redraw filtering: balanced, strict, off
`unfoldai.terminal.commandTimeoutMs`	number	`300000`	Command timeout in ms (30s–3600s)
`unfoldai.terminal.completionChips.enabled`	boolean	`false`	Show completion status chips
`unfoldai.terminal.quickActions.enabled`	boolean	`true`	Enable quick action commands
`unfoldai.terminal.historyPersistence.enabled`	boolean	`false`	Persist command history
`unfoldai.terminal.historyPersistence.maxEntries`	number	`120`	Max persisted history entries (20–500)
`unfoldai.terminal.reliabilityTelemetry.enabled`	boolean	`true`	Share anonymous terminal reliability data