Secondary Terminal - VS Code Extension

The Essential Tool for the CLI Coding Agent Era - A production-ready terminal extension designed for developers who need more than VS Code's standard terminal. Manage up to 5 terminals across sidebar and panel with exceptional compatibility for Claude Code, Codex CLI, Gemini CLI, and GitHub Copilot. Features complete TypeScript compliance with ProcessState/InteractionState management for maximum reliability.
⚠️ Active Development Notice: This extension is under active development with new features being added continuously. Please expect some bugs and incomplete functionality as we work to improve the experience.

✨ Key Features
🚀 Advanced Terminal Management
- VS Code Standard Compliance: Complete ProcessState enum implementation (Uninitialized, Launching, Running, KilledDuringLaunch, KilledByUser, KilledByProcess)
- InteractionState Tracking: Advanced state management with None, ReplayOnly, and Session states
- Production-Ready Architecture: Zero TypeScript compilation errors with 562 KiB extension and 1.05 MiB webview builds
- Sidebar Integration: Dedicated terminal panel in the VS Code activity bar
- Multiple Terminals: Support for up to 5 concurrent terminal instances
- Smart Session Persistence: Automatically saves and restores terminal sessions across VS Code restarts
- Terminal Recycling: Efficient terminal number management (1-5) with automatic reuse
- Enhanced Error Handling: Robust error recovery mechanisms following VS Code standards
- Cross-Platform Support: Works seamlessly on Windows, macOS, and Linux
🤖 AI Agent Integration
- Enhanced Detection Engine: Improved CLI agent detection with advanced pattern recognition
- Claude Code Support: Full integration with
claude-code
commands and session restoration (detects "Claude Code" startup message)
- Codex CLI Support: Complete integration with
codex
commands and AI-powered development assistance
- CodeRabbit CLI Integration: Custom slash command support for AI code reviews with smart mode selection
- GitHub Copilot Integration: File reference shortcuts with
#file:
format (CMD+K CMD+C)
- Gemini CLI Support: Complete integration with
gemini code
commands
- Always-Visible Status: AI agent status remains permanently visible once detected (v0.1.101+)
- Real-time Status Tracking: Live AI agent status indicators with connection/disconnection detection
- Smart Toggle Controls: One-click AI agent switching with status-aware button visibility
- Manual Reset Functionality: Force reconnect AI agents when detection issues occur
- Timeout-based Detection: Intelligent timeout handling for reliable state management
🔧 Developer Experience
- Version Information Display: Built-in version display in Terminal Settings with "About" section and command palette support (v0.1.105+)
- Streamlined UI: Compact "ST" panel title for cleaner activity bar (v0.1.105+)
- Tab Click Fullscreen: Click any tab to show that terminal in fullscreen, hiding others - click active tab again to toggle split view (v0.1.110+)
- Smart Display Modes: Seamless transitions between normal, fullscreen, and split views with automatic mode indicators (v0.1.110+)
- Alt+Click Cursor Positioning: VS Code-standard cursor positioning with intelligent CLI agent conflict detection
- Smart File Reference System: Instantly share code with AI agents using CMD+Option+L - automatically targets "AI Agent Connected" terminals
- Multi-Agent Workflow: Seamlessly work with multiple AI agents across different terminals simultaneously
- Tab Close Button: Hover-visible white × button for closing terminals, with last tab protection (v0.1.108+)
- Stable Tab Visibility: Terminal tabs remain visible throughout all operations (v0.1.109+)
- IME Support: Full Japanese and multi-language input method support
- Split Terminal Views: Vertical and horizontal terminal splitting optimized for AI agent workflows
- Command Palette Integration: Full VS Code command palette support
- Production-Grade Quality: Zero TypeScript compilation errors with comprehensive ESLint compliance (0 errors, 333 acceptable warnings)
- Optimized Build Process: 562 KiB extension + 1.05 MiB webview builds with stable performance
- Adaptive Performance: Dynamic buffering optimization for AI agent output (250fps during active sessions)
- Debug Panel: Real-time system monitoring with Ctrl+Shift+D shortcut
- Memory Management: Efficient resource cleanup and leak prevention
- Output Optimization: Smart flushing intervals (2-16ms) based on activity patterns
- Subtle Notifications: Improved visual design with reduced opacity and VS Code integration
🎯 Quick Start
Why Secondary Terminal?
"With CLI coding agents becoming widespread these days, isn't VS Code's standard terminal alone sometimes insufficient?"
Optimized for modern developers who need to use multiple AI agents simultaneously and efficiently send file references. Perfect for the era where AI-powered coding assistants are essential development tools.
Installation
- From VS Code Marketplace: Search for "Secondary Terminal" in the Extensions view
- From Command Line:
code --install-extension s-hiraoku.vscode-sidebar-terminal
- Manual Installation: Download VSIX from releases
First Use
- Click the terminal icon in the activity bar or use
Ctrl+Shift+P
→ "Focus Terminal"
- The extension automatically creates an initial terminal with your default shell
- Start using AI agents by running
claude-code "your command"
or gemini code "your task"
- Look for "AI Agent Connected" status indicator to confirm agent connection
📖 Want more details? Check out our comprehensive blog article for detailed usage examples and advanced workflows.
🔑 Keyboard Shortcuts
Shortcut |
Action |
Description |
CMD+Option+L (Mac)
Ctrl+Alt+L (Win/Linux) |
File Reference |
Send current file to "AI Agent Connected" terminals with @filename format - essential for efficient AI agent workflows |
CMD+K CMD+C (Mac)
Ctrl+K Ctrl+C (Win/Linux) |
Copilot Integration |
Activate GitHub Copilot Chat with #file: reference |
Alt+Click |
Cursor Positioning |
Position terminal cursor (VS Code standard behavior) |
Ctrl+Shift+D |
Debug Panel |
Toggle real-time system monitoring panel |
Ctrl+Shift+X |
Export Diagnostics |
Export system diagnostics to clipboard |
🎮 Command Palette Commands
Access these commands via Ctrl+Shift+P
(Windows/Linux) or Cmd+Shift+P
(Mac):
Command |
Description |
Secondary Terminal: Show Version |
Display extension version information |
Secondary Terminal: Focus Terminal |
Focus on the terminal panel |
Secondary Terminal: Split Terminal |
Split terminal vertically |
Secondary Terminal: Split Terminal Horizontal |
Split terminal horizontally |
Secondary Terminal: Clear Corrupted History |
Clear corrupted terminal session history |
Secondary Terminal: Manage Terminal Profiles |
Open terminal profile manager |
🏗️ Architecture Overview
Core Components
Extension Host (Node.js)
- TerminalManager: Manages PTY processes, terminal lifecycle, and AI agent detection
- RefactoredSecondaryTerminalProvider: WebView provider with comprehensive message handling
- AI Agent Services: Dedicated services for Claude, Gemini, Codex, and GitHub Copilot CLI integration
- Session Management: Persistent terminal state across VS Code sessions
WebView (Browser Environment)
- RefactoredTerminalWebviewManager: Central coordinator for all WebView operations
- Manager Ecosystem: Specialized managers for Input, UI, Performance, Notifications, Splitting, and Configuration
- xterm.js Integration: Full-featured terminal emulation with custom enhancements
Communication Flow
User Input → VS Code Commands → Extension Host → WebView Messages → xterm.js
↕ ↕ ↕
TerminalManager ←→ node-pty processes ←→ Shell/AI Agents
🤖 AI Agent Integration
Secondary Terminal is specifically designed to work seamlessly with modern CLI coding agents. Here's how to get the most out of each supported agent:
🎯 Getting Started with AI Agents
Step 1: Launch Your AI Agent
Choose your preferred AI agent and launch it in Secondary Terminal:
# Claude Code (Anthropic)
claude-code "help me with this React component"
# Codex CLI (OpenAI)
codex "generate unit tests for this function"
# GitHub Copilot CLI
copilot "explain this error message"
# Gemini CLI (Google)
gemini code "optimize this Python function"
# For GitHub Copilot - use the keyboard shortcut
# CMD+K CMD+C (Mac) or Ctrl+K Ctrl+C (Win/Linux)
Step 2: Look for Connection Status
Watch for the "AI Agent Connected" indicator in the terminal header - this shows which terminals are actively connected to AI agents.
Step 3: Use File References
Press CMD+Option+L
(Mac) or Ctrl+Alt+L
(Win/Linux) while editing a file to instantly share it with connected AI agents using the @filename
format.
🔧 Supported AI Agents
Claude Code (Anthropic)
- Launch Command:
claude-code "your task description"
- File Sharing: Automatic
@filename
references via CMD+Option+L
- Session Persistence: Complete command history and context restoration across VS Code restarts
- Status Detection: Real-time connection/disconnection monitoring
- Best For: Complex reasoning tasks, code refactoring, architectural decisions
GitHub Copilot CLI
- Launch Command:
copilot
or gh copilot
- Auto-Detection: Detects "Welcome to GitHub Copilot CLI" message
- Session Management: Full lifecycle tracking with connected/disconnected states
- File References: Supports
@filename
context sharing
- Best For: AI-powered CLI assistance, command suggestions, code explanations
Codex CLI (OpenAI)
- Launch Command:
codex "your development task"
- AI-Powered Assistance: Advanced code generation and completion capabilities
- Multi-Language Support: Supports multiple programming languages and frameworks
- Session Management: Complete command history and context preservation
- Best For: Code generation, refactoring, documentation, unit test creation
CodeRabbit CLI
- Slash Command:
/coderabbit
(when using Claude Code)
- Mode Selection:
--prompt-only
: Optimized for AI agent integration
--plain
: Detailed human-readable feedback
- Custom Flags: Full support for CodeRabbit CLI arguments
- Best For: Code reviews, quality analysis, security audits
Gemini CLI (Google)
- Launch Command:
gemini code "your development task"
- ASCII Art Detection: Recognizes unique GEMINI startup graphics and visual indicators
- Session Management: Complete lifecycle tracking and restoration
- Auto-Detection: Intelligent startup and termination recognition with visual pattern matching
- File References: Full
@filename
support
- Best For: Code generation, debugging, performance optimization
🚀 Advanced AI Workflows
Multi-Agent Workflow
Launch multiple agents in different terminals:
# Terminal 1: Claude Code for architecture
claude-code "help design this system"
# Terminal 2: GitHub Copilot CLI for implementation
copilot "implement the user service with TypeScript"
# Terminal 3: Codex for testing
codex "create comprehensive unit tests"
# Terminal 4: Gemini for optimization
gemini code "optimize the user service performance"
Share files efficiently using CMD+Option+L to send the same file to all connected agents
Switch between contexts using terminal tabs while maintaining separate conversations
File Reference System
- Automatic Detection: Extension automatically detects "AI Agent Connected" terminals
- Smart Targeting: CMD+Option+L sends files only to connected AI agents
- Format Consistency: Uses standardized
@filename
format across all agents
- Context Preservation: Maintains file references across terminal sessions
🎛️ AI Agent Configuration
Detection Settings
{
"secondaryTerminal.enableCliAgentIntegration": true,
"secondaryTerminal.enableGitHubCopilotIntegration": true,
"secondaryTerminal.focusAfterAtMention": true
}
- High-Speed Output: 250fps processing during active AI sessions
- Smart Buffering: Adaptive buffering based on agent activity
- Memory Optimization: Efficient cleanup of agent sessions
🔍 Troubleshooting AI Agents
Agent Not Detected?
- Check the terminal header for "AI Agent Connected" status
- Verify the agent is properly installed and accessible
- Use the debug panel (Ctrl+Shift+D) for detection logs
- Try the manual reset functionality if needed
File References Not Working?
- Ensure
secondaryTerminal.enableCliAgentIntegration
is enabled
- Verify you're using CMD+Option+L (not Ctrl+Alt+L on Mac)
- Check that at least one terminal shows "AI Agent Connected"
- Try refreshing the terminal connection
💡 Pro Tips
- Tab Click Fullscreen (v0.1.110+): Click any terminal tab to focus on that terminal fullscreen - perfect for focusing on specific AI agent conversations
- Toggle Split View: Click the active tab again to switch between fullscreen and split view showing all terminals
- Smart Display Modes: The extension automatically manages display transitions (normal → fullscreen → split) based on your tab interactions
- Use Split Terminals: Keep multiple AI agents visible simultaneously
- Session Persistence: Your AI conversations are automatically restored after VS Code restarts
- Keyboard Efficiency: Master CMD+Option+L for instant file sharing
- Debug Panel: Use Ctrl+Shift+D to monitor AI agent status in real-time
Dynamic Buffering System
The extension uses an advanced buffering system that adapts to different usage patterns:
- Normal Operations: 16ms flush intervals (~60fps)
- Active Typing: Immediate processing for responsive input
- AI Agent Mode: 2-4ms intervals (~250fps) for smooth AI output
- Large Output: Immediate processing for chunks >1000 characters
Memory Management
- Resource Cleanup: Automatic disposal of terminals, listeners, and buffers
- Leak Prevention: Comprehensive cleanup on extension deactivation
- Efficient Caching: Smart caching of frequently accessed elements
🔧 Configuration Options
Terminal Behavior
{
"secondaryTerminal.shell": "auto",
"secondaryTerminal.shellArgs": [],
"secondaryTerminal.maxTerminals": 5,
"secondaryTerminal.enableCliAgentIntegration": true,
"secondaryTerminal.enableGitHubCopilotIntegration": true
}
Display Settings
{
"secondaryTerminal.fontSize": 14,
"secondaryTerminal.fontFamily": "Monaco, 'Courier New', monospace",
"secondaryTerminal.cursorBlink": true,
"secondaryTerminal.theme": "dark"
}
{
"secondaryTerminal.bufferFlushInterval": 16,
"secondaryTerminal.maxBufferSize": 10000,
"secondaryTerminal.enablePerformanceOptimization": true
}
🛠️ Development & Testing
Building from Source
git clone https://github.com/s-hiraoku/vscode-sidebar-terminal.git
cd vscode-sidebar-terminal
npm install
npm run compile
Testing
# Run unit tests (275+ tests)
npm test
# Test with coverage
npm run test:coverage
# Watch mode for TDD
npm run watch-tests
Development Commands
npm run compile # Build extension and webview
npm run watch # Watch mode for development
npm run lint # ESLint checking
npm run package # Create production VSIX
Quality Gates
The project maintains strict quality standards:
- Test Coverage: 85%+ with 275+ comprehensive tests
- TDD Compliance: 50%+ (targeting 85%)
- ESLint: Zero errors (warnings acceptable)
- TypeScript: Strict compilation with full type safety
🧪 Testing Strategy
Comprehensive Test Suite
- Unit Tests: 275+ tests covering core functionality
- Integration Tests: End-to-end AI agent interaction scenarios
- Performance Tests: Buffer management and memory optimization
- Edge Case Tests: Error handling and resource cleanup
Test Categories
- Terminal Management: Creation, deletion, switching, and lifecycle
- AI Agent Integration: Detection, status tracking, and command processing
- Strategy pattern for agent-specific detection logic
- Simplified detection patterns to reduce false positives
- ASCII art recognition for unique agent startup graphics
- Standardized activity detection across all supported agents
- Session Persistence: Save/restore functionality across restarts
- Performance: Buffering, flushing, and memory management
- UI Components: Header management, status displays, and user interactions
🐛 Troubleshooting
Common Issues
Terminal Not Starting
# Check shell configuration
"secondaryTerminal.shell": "/bin/bash" # or your preferred shell
AI Agent Not Detected
- Ensure AI agent integration is enabled in settings
- Verify the AI agent is properly installed and accessible
- Check the debug panel (Ctrl+Shift+D) for detection logs
- Enable performance optimization in settings
- Check system resources and terminal count
- Use the debug panel to monitor buffer statistics
- Debug Panel: Ctrl+Shift+D for real-time system monitoring
- Diagnostics Export: Ctrl+Shift+X for comprehensive system information
- Developer Console: F12 for WebView debugging (development mode)
🚀 Release Process
Automated CI/CD
The project uses GitHub Actions for automated testing and releases:
- Quality Gate: TDD compliance and test coverage validation
- Multi-Platform Build: Automatic VSIX generation for all supported platforms
- Marketplace Publishing: Automatic publishing on version tags
- Release Notes: Automated changelog generation
- Windows: win32-x64, win32-arm64
- macOS: darwin-x64, darwin-arm64 (Apple Silicon)
- Linux: linux-x64, linux-arm64, linux-armhf
- Alpine: alpine-x64, alpine-arm64
📈 Version History
v0.1.109 (Current) - 🐛 Terminal Tabs Visibility Fix
- 🐛 Terminal Tabs Fix: Fixed tabs disappearing after terminal creation (regression from v0.1.108)
- 🔧 Container Preservation: Tabs container now preserved when clearing placeholder content
- ✅ Initialization Stability: Ensured proper WebView initialization sequence
- ✨ Tab Close Button: Added hover-visible white × button for closing terminals with smart last-tab protection
- 🎨 Stable Tab Layout: Tab size remains constant during hover, preventing layout shift
- 🤖 Enhanced Claude Code Detection: Updated detection pattern to match new "Claude Code" startup message format
- 🔧 Event Delegation: Improved event handling architecture to prevent duplicate listeners and memory leaks
- 🛡️ Last Tab Protection: Prevents accidental closure of the last terminal with warning notification
- 🎯 Global Event Handling: Implemented efficient event delegation pattern for better performance
v0.1.107 - 🎨 UI Correction
- 🎨 Panel Title Fix: Corrected activity bar abbreviation from "SC" to "ST" (Secondary Terminal)
- 📝 Documentation Updates: Fixed all references in package.json, CHANGELOG.md, and README.md
- ✨ Improved Clarity: ST is more intuitive and recognizable as Secondary Terminal
v0.1.106 - 🔧 Build System Fix
- 🔧 TypeScript Compilation: Fixed build errors in GitHub Actions multi-platform workflow
- ✅ Test Mock Updates: Added missing
setVersionInfo
method to test coordinators
- 🛠️ Type Safety: Enhanced type guards for version parameter handling
- 📦 CI/CD Stability: Resolved multi-platform packaging workflow failures
- 🏷️ Version Display: Added version information display in Terminal Settings with "About" section
- 🎯 Command Palette: Added "Show Version" command for quick version checking
- 📦 VersionUtils Class: Created utility class to dynamically retrieve version from package.json
- 🎨 Compact UI: Changed activity bar title from "Secondary Terminal" to "ST" for cleaner interface
- 🔧 Type Safety: Fixed TypeScript compilation errors for production-ready builds
v0.1.104 - 🤖 GitHub Copilot CLI Support & Enhanced AI Detection
- 🆕 GitHub Copilot CLI: Added full support for GitHub Copilot CLI integration
- 🎯 Simplified Detection: Streamlined AI agent detection patterns for better reliability
- 🔄 Reconnection Fix: Fixed disconnected AI agent reconnection issues
- 📈 Detection Accuracy: Improved pattern matching across all AI agents
v0.1.95 - 📁 Documentation Organization & Codex CLI Support
- 📁 Documentation Structure: Organized 25+ documentation files into categorized
/docs/
directory structure
- 📖 Enhanced Navigation: Created comprehensive docs/README.md with structured directory navigation
- 🤖 Codex CLI Integration: Added support for OpenAI Codex CLI with complete AI agent functionality
- 📦 Dependency Updates: Updated @xterm/addon-web-links to v0.11.0 for improved link handling
- 🗂️ Project Organization: Cleaned root directory structure for better maintainability
- 🚀 Developer Experience: Improved project navigation with organized documentation structure
v0.1.94 - 📚 Comprehensive AI Agent Documentation & Enhanced UX
- 📖 Complete AI Agent Guide: Added comprehensive documentation for Claude Code, Gemini CLI, GitHub Copilot, and CodeRabbit CLI integration
- 🎯 CLI Agent Era Positioning: Enhanced value proposition for modern AI-assisted development workflows
- 🔧 Multi-Agent Workflows: Detailed documentation for advanced multi-agent usage patterns and best practices
- 🚀 Development Transparency: Clear development status communication with bug acknowledgment and user expectations
- 📝 Documentation Excellence: Completely revamped README.md with step-by-step guides and troubleshooting
- 🌐 Zenn Blog Integration: Added references to comprehensive Japanese blog article for detailed usage examples
v0.1.86 - 🔧 AI Agent Toggle Enhancement
- 📎 AI Agentトグル改善: クリップボタンでconnectedエージェント移動時、前のconnectedをdisconnectedに変更
- ⚡ シームレスな状態遷移: より直感的なAI Agent切り替え動作
- 🎨 Toaster通知の控えめ化: 25%透明度向上とカラー調整で視覚的な邪魔を軽減
v0.1.85 - 🚑 Critical Cleanup & Manual Reset
- 🗑️ 重複コード削除:
src/integration/
フォルダ全体と未使用ファイル完全削除
- 🔄 手動リセット機能: AI Agent検知エラー時の強制再接続機能追加
- 🎯 コードベース整理: 実際に使用されているコードのみ保持
- ✅ 検知精度向上: 過剰検知への対応策実装
v0.1.84 - 🚑 日本語入力完全修復+品質改善
- 🇯🇵 日本語入力問題の完全解決:
terminal.onData()
でのIME入力ブロックを削除
- ✅ VS Code標準準拠: 統合ターミナルと同等のIME処理品質を実現
- ✅ IME確定文字の確実反映: ひらがな・カタカナ・漢字変換が100%動作
- ⚡ xterm.js内蔵処理委任: 安定性向上と遅延ゼロ実現
- 🔧 根本原因修正:
isIMEComposing()
による不適切な入力ブロック削除
- 📊 ESLintエラー大幅削減: 21個→11個(48%削減)で品質向上
v0.1.81 - 🔧 TypeScript Quality Improvements
- ✅ CI/CD TypeScript エラー完全修正: GitHub Actions Pre-Release Quality Gate 通過
- ✅ MessageHandlerContext型定義改善: より実用的で柔軟な型設計
- ✅ コンパイル安定性確保: webpack、tsc両方で完全成功
- ✅ テストスイート完全対応: 全テストファイルのTypeScriptコンパイル成功
- 🚀 CI/CDパイプライン安定化: 自動ビルド・テストの信頼性向上
- 📊 ESLint品質維持: エラー0個、警告154個(許容範囲)
- 🔍 型チェック最適化: 実用性と型安全性のバランス調整
- 🇯🇵 日本語入力完全修復: 日本語・ひらがな・カタカナ・漢字変換が100%確実に動作
- ⚡ 即座の入力処理: IME compositionend後の遅延処理を完全削除し、瞬時の入力反映を実現
- 🔧 シンプル化されたIME処理: 過剰な二重チェックとバッファー処理を削除、軽量で確実な動作
- 🏥 緊急品質修正: v0.1.78で発生した日本語入力完全阻害問題を即座に解決
- 📦 軽量化: WebView 2KB削減 (962KB→960KB) でパフォーマンス向上
- ✅ VS Code標準品質: VS Code統合ターミナルと同等レベルの多言語入力サポート
v0.1.79
- 📚 リリースノート整備: 包括的なリリース情報とドキュメント更新
v0.1.78
- 🏗️ Service-Oriented Architecture: Extracted WebView HTML generation and message routing services
- 📦 WebView HTML Generation Service: Centralized HTML generation with CSP security and nonce management
- 🔄 Message Routing Service: Plugin-based message handler architecture with 20+ command support
- 🎯 Unified Provider Coordinator: Reduced SecondaryTerminalProvider complexity by 33% (2,122→1,400 lines)
- ⚡ Enhanced Type Safety: Fixed critical TypeScript compilation errors and improved type definitions
- 🧪 Comprehensive Testing: Added 900+ lines of tests for new services with edge case coverage
- 📚 Documentation Updates: Enhanced CLAUDE.md guidelines and architectural documentation
v0.1.77
- ✨ Enhanced AI Agent Integration: Improved Claude Code and Gemini CLI detection
- 🔧 Performance Optimizations: Dynamic buffering system for AI agent output
- 🐛 Critical Fixes: Resolved terminal deletion race conditions and memory leaks
- 📚 Documentation: Comprehensive README and implementation guides
v0.1.73
- 🔄 Refactored Architecture: Complete WebView manager system overhaul
- ⚡ Performance Improvements: Optimized terminal rendering and resource management
- 🧪 Enhanced Testing: 275+ comprehensive tests with 93% success rate
v0.1.55
- 🎯 AI Agent Status Fix: Resolved flickering status indicators during execution
- 🔧 Detection Improvements: Enhanced startup and termination pattern recognition
- 📊 Stability Enhancements: Improved state management and error handling
🤝 Contributing
We welcome contributions! Please see our GitHub Issues to get started.
Development Setup
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature
- Follow TDD practices: Write tests first, then implement
- Ensure all quality gates pass:
npm run pre-release:check
- Submit a pull request with detailed description
Emergency Rollback Procedures
If you encounter critical issues with a release, we provide automated rollback capabilities:
🚨 Emergency Rollback (Fully Automated)
# Complete automatic rollback + marketplace publishing
npm run rollback:emergency:publish
# Local rollback only (requires manual publishing)
npm run rollback:emergency
🔧 Targeted Rollback
# List available versions for rollback
npm run rollback:list
# Rollback to specific version
npm run rollback:to 0.1.95
# Pre-publish safety verification
npm run rollback:verify
📊 Release Monitoring
# Single monitoring check
npm run monitor:check
# Continuous monitoring (30min intervals)
npm run monitor:continuous
🔥 Hotfix Release
# Automated hotfix workflow
npm run rollback:hotfix
📚 Complete Rollback Documentation:
Code Standards
- TypeScript: Strict typing with comprehensive interfaces
- Testing: TDD approach with comprehensive test coverage
- Documentation: Clear inline comments and updated guides
- Performance: Memory-efficient implementations with proper cleanup
- Release Safety: Automated rollback system for production stability
📝 License
This project is licensed under the MIT License - see the LICENSE file for details.
🙋 Support & Contributing
🚧 Development Status: This extension is actively being developed with frequent updates. New features are continuously being added, and there may be some bugs or incomplete functionality. We appreciate your patience and feedback!
Get Help & Report Issues
Known Limitations
- Some features may be incomplete or have rough edges
- New releases are frequent as we continuously add functionality
- Documentation is being updated regularly to keep pace with development
Built with ❤️ for VS Code developers working with AI agents
Supports Claude Code, GitHub Copilot, Gemini CLI, and more