Terminal Context Manager (TCM)
Securely manage terminal environment variables, secrets, and SSH connections in VS Code.
📖 For developers: Development Guide • Contributing
English | 中文
English
✨ Features
🔐 Secure Secret Management
- Store sensitive data using VS Code's native SecretStorage (OS keychain)
- Reference secrets in environment variables without exposing values
- Automatic encryption and decryption
📦 Profile Management
- Global Profiles: Reusable configurations across all projects
- Workspace Profiles: Project-specific configurations stored in
.vscode/tcm.json
- Profile Inheritance: Extend and override parent profiles
- Templates: Pre-configured profiles for Git, AI, DevOps, Node.js
🖥️ Enhanced Terminal Experience
- Create new terminals with environment variables pre-configured
- Apply profiles to existing terminals
- Custom terminal icons and colors
- Auto-run commands on terminal creation
- Platform-specific command support (Windows/macOS/Linux)
🌐 SSH Connection Management
- Manage SSH connections with groups
- Quick connect with one click
- Store connection configurations securely
📥 Import & Export
- Import from
.env files
- Use templates from GitHub/Gitee repositories
- Export configurations for team sharing
🌍 Internationalization
- English and Chinese (Simplified) support
- Automatic language detection based on VS Code settings
🎯 Quick Start
1. Add a Secret
- Click the TCM icon in the Activity Bar
- In the "Secrets" view, click the
+ button
- Enter the secret name and value
- The secret is encrypted and stored securely
2. Create a Profile
- In the "Profiles" view, click the
+ button
- Choose Global or Workspace scope
- Add environment variables:
- Literal: Plain text values
- Secret Reference: Link to encrypted secrets
3. Launch Terminal with Profile
- Click 🖥️ (terminal icon) on any profile to create a new terminal with environment variables
- Click ▶️ (play icon) to apply to the active terminal
📚 Use Cases
Git Development
{
"GIT_AUTHOR_NAME": "Your Name",
"GIT_AUTHOR_EMAIL": "you@example.com"
}
AI Development
{
"OPENAI_API_KEY": "<secret-ref>",
"ANTHROPIC_API_KEY": "<secret-ref>"
}
Cloud DevOps
{
"AWS_ACCESS_KEY_ID": "<secret-ref>",
"AWS_SECRET_ACCESS_KEY": "<secret-ref>",
"AWS_REGION": "us-east-1"
}
🛠️ Commands
| Command |
Description |
TCM: Add Secret |
Create a new encrypted secret |
TCM: Add Profile |
Create a new environment profile |
TCM: Create from Template |
Use a pre-configured template |
TCM: Launch Terminal with Profile |
Create a new terminal with environment |
TCM: Apply Profile |
Apply to the active terminal |
TCM: Add SSH Connection |
Add a new SSH connection |
TCM: Connect SSH |
Connect to an SSH server |
- Windows - PowerShell (
$env:KEY="value")
- Linux/macOS - Bash/Zsh (
export KEY="value")
中文
✨ 功能特性
🔐 安全的密钥管理
- 使用 VS Code 原生 SecretStorage（操作系统密钥链）存储敏感数据
- 在环境变量中引用密钥而不暴露值
- 自动加密和解密
📦 配置文件管理
- 全局配置：跨所有项目可复用的配置
- 工作区配置：存储在
.vscode/tcm.json 中的项目特定配置
- 配置继承：扩展和覆盖父配置
- 模板：Git、AI、DevOps、Node.js 的预配置模板
🖥️ 增强的终端体验
- 创建预配置环境变量的新终端
- 将配置应用到现有终端
- 自定义终端图标和颜色
- 终端创建后自动运行命令
- 平台特定命令支持（Windows/macOS/Linux）
🌐 SSH 连接管理
- 使用分组管理 SSH 连接
- 一键快速连接
- 安全存储连接配置
📥 导入与导出
- 从
.env 文件导入
- 使用 GitHub/Gitee 仓库的模板
- 导出配置供团队共享
🌍 国际化
- 英文和中文（简体）支持
- 根据 VS Code 设置自动检测语言
🎯 快速开始
1. 添加密钥
- 点击活动栏中的 TCM 图标
- 在 "Secrets" 视图中，点击
+ 按钮
- 输入密钥名称和值
- 密钥被加密并安全存储
2. 创建配置
- 在 "Profiles" 视图中，点击
+ 按钮
- 选择全局或工作区范围
- 添加环境变量：
3. 使用配置启动终端
- 点击任何配置上的 🖥️（终端图标）创建带环境变量的新终端
- 点击 ▶️（播放图标）应用到当前终端
🛠️ 命令
| 命令 |
描述 |
TCM: Add Secret |
创建新的加密密钥 |
TCM: Add Profile |
创建新的环境配置 |
TCM: Create from Template |
使用预配置模板 |
TCM: Launch Terminal with Profile |
创建带环境的新终端 |
TCM: Apply Profile |
应用到当前终端 |
TCM: Add SSH Connection |
添加新的 SSH 连接 |
TCM: Connect SSH |
连接到 SSH 服务器 |
📬 Support
📄 License
MIT License - see the LICENSE for details.
Made with ❤️ for VS Code developers
| |
