Terminal History Outline

View and manage your terminal command history directly in the VS Code Explorer outline view.

Features

• 📝 Command History - Automatically captures every command and its output
• 🟢/🔴/🟡 Status Indicators - Shows success, failure, or running status
• 🔧 Actions - Rerun commands, copy output, clear history
• 🔒 Security - Detects and redacts passwords, API keys, and tokens (v0.4.0)
• 📊 Privacy Dashboard - View and manage your security settings
• 🎨 Clean Display - Strips ANSI codes and shows clean output
• 💾 Persistent - History survives VS Code restarts

Demo

Terminal History Outline in action

From VSIX (Manual Download)

1. Download the latest .vsix file:

   • From GitHub Releases
   • Or via direct link: Download Latest VSIX

2. Install the extension:

   • VS Code UI: Extensions → ... → Install from VSIX → Select the file
   • Command Line: code --install-extension terminal-history-outline-1.0.0.vsix

From VS Code Marketplace (Coming Soon)

The extension will be available on the Marketplace after beta testing.

From Source (For Development)

git clone https://github.com/chamren86/terminal-history-outline.git
cd terminal-history-outline
npm install
npm run compile

Press F5 to launch the extension in a development window.

Usage

1. Open a terminal (Ctrl+`)
2. Run any command - it appears in the Terminal History view (Explorer sidebar)
3. Click a command to see its output
4. Right-click for actions: Rerun, Copy Output

Commands

Configuration

VS Code settings (Ctrl+,):

{
    "terminalHistory.maxHistorySize": 100,
    "terminalHistory.security.detectionEnabled": true,
    "terminalHistory.security.redactionLevel": "warn",
    "terminalHistory.security.warnOnDetection": true,
    "terminalHistory.security.customPatterns": [],
    "terminalHistory.security.excludedCommands": []
}

Security Settings

Development

Prerequisites

• Node.js 18+
• npm

Setup

git clone https://github.com/chamren86/terminal-history-outline.git
cd terminal-history-outline
npm install
npm run compile

Testing

Install act for GitHub Actions Testing (Optional)

To test GitHub Actions locally:

• Ubuntu/Debian: curl -s https://raw.githubusercontent.com/nektos/act/master/install.sh | sudo bash
• macOS: brew install act
• Windows: choco install act
• More info: https://github.com/nektos/act

Project Structure

src/
├── cleaner.ts              # ANSI cleaning
├── extension.ts            # Extension activation
├── security.ts             # Security module
├── privacyCommands.ts      # Privacy dashboard commands
├── terminalHistoryProvider.ts # Tree provider
└── test/                   # Unit tests
    ├── unit/
    │   ├── ansiCleanerTest.ts    # ANSI cleaning tests
    │   └── securityTest.ts       # Security tests
    └── fixtures/
        └── sampleOutputs.ts      # Test data

Requirements

• VS Code 1.93+
• Shell Integration enabled (default: on)

Enabling Shell Integration

If commands aren't being captured, ensure Shell Integration is enabled:

1. Open VS Code Settings (Ctrl+,)
2. Search for "shell integration enabled"
3. Check Terminal > Integrated > Shell Integration: Enabled

Roadmap

v1.1.0 - Groups & Organization
v1.2.0 - AI & Agent Integration
v1.3.0 - Export & Save
v1.4.0 - Customization & UX

Full Roadmap Feature Details

Release Notes

Full Release Notes

License

MIT © chamren86

Enjoy tracking your terminal history! 🚀