Geminicli扩展管理工具

Geminicli插件管理器

英语 | 繁体中文

英语

用于管理的基于文本的用户界面（TUI）工具 双子座 扩展和MCP（模型上下文协议）服务器。

特性

• 🎯 扩展管理：启用/禁用Geminicli扩展
• 🔌 基于扩展的MCP服务器管理：在扩展中控制MCP服务器
• 🌐 独立MCP服务器管理：从管理独立的MCP服务器 settings.json
• 🎨 交互式TUI：易于使用的终端界面，带键盘导航
• 💾 自动备份：保存前自动备份配置文件
• ⚡ 快速轻便：使用React Ink构建，实现流畅的终端渲染

截图

安装

先决条件

• Node.js>=18.0.0
• 双子座 已安装并配置

从npm安装（推荐）

npm install -g geminicli-manage-addon

从源代码安装

git clone https://github.com/yourusername/geminicli-manage-addon.git
cd geminicli-manage-addon
npm install
npm link

用法

运行TUI

geminicli-manage-addon

键盘控制

与Geminicli集成

您还可以使用以下命令直接从Geminicli运行此工具 /manage-addon 斜线命令：

1. 创建 ~/.gemini/commands/manage-addon.toml:

description = "Manage extensions and MCP servers"

prompt = """
I will launch the Geminicli Addon Manager TUI tool for you.

IMPORTANT INSTRUCTIONS:
1. Use Ctrl+F to interact with the TUI tool (arrow keys, space, enter)
2. After making changes, you MUST restart Gemini CLI for the new settings to take effect

Running the tool now...

Execute: `geminicli-manage-addon`

After you finish:
- Press Enter to save and exit
- Press Esc to exit without saving
- Then restart Gemini CLI to apply the changes
"""

2. 在Geminicli中，键入：

/manage-addon

3. 重要：新闻 Ctrl+F 与TUI互动

4. 更改后：重新启动Gemini CLI以应用新设置

配置文件

此工具管理以下配置文件：

所有文件都会自动备份 .bak 保存前进行扩展。

运作原理

扩展管理

通过修改来启用/禁用扩展 overrides 数组in extension-enablement.json:

• 启用： ["/Users/username/*"]
• 残疾人： ["!/Users/username/*"]

基于扩展的MCP服务器

扩展内的MCP服务器通过以下方式进行管理 mcp-server-enablement.json:

{
  "github": {
    "github": true
  },
  "chrome-devtools-mcp": {
    "chrome-devtools": false
  }
}

独立MCP服务器

独立MCP服务器（定义见 settings.json)通过管理 mcp.excluded 数组：

{
  "mcp": {
    "excluded": ["pointer", "context7", "deepwiki"]
  }
}

发展

设置

git clone https://github.com/castle-studio-work/geminicli-manage-addon.git
cd geminicli-manage-addon
npm install

在本地运行

npm start

项目结构

geminicli-manage-addon/
├── index.js          # Entry point
├── ui.js             # TUI logic and components
├── package.json      # Project configuration
└── README.md         # This file

技术细节

• 框架: 墨水 -为CLIs做出反应
• 语言：ES6模块（Node.js）
• 兼容性：Node.js v18+（在v25.2.1上测试）
• 无JSX：用途 React.createElement 为了获得最大的兼容性

故障排除

命令未找到

如果 geminicli-manage-addon 安装后找不到：

1. 检查npm全局bin目录：

   复制

   npm config get prefix
   

2. 确保bin目录在PATH中：

   复制

   export PATH="$(npm config get prefix)/bin:$PATH"
   

权限错误

如果保存时遇到权限错误：

# Check file permissions
ls -la ~/.gemini/extensions/extension-enablement.json
ls -la ~/.gemini/settings.json

# Fix if needed
chmod 644 ~/.gemini/extensions/extension-enablement.json
chmod 644 ~/.gemini/settings.json

贡献

欢迎投稿！请随时提交拉取请求。

1. 复刻仓库
2. 创建功能分支(git checkout -b feature/AmazingFeature)
3. 提交您的更改(git commit -m 'Add some AmazingFeature')
4. 推到分支(git push origin feature/AmazingFeature)
5. 打开拉取请求

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

致谢

• 专为 双子座
• 由...驱动 墨水
• 灵感来自对更简单的Geminicli配置管理的需求

支持

如果您遇到任何问题或有疑问：

• 🐛 报告错误
• 💡 请求功能
• 📖 阅读文档

更新日志

v1.0.0（2025-11-30）

• ✨ 初始版本
• ✅ 扩展管理
• ✅ 基于扩展的MCP服务器管理
• ✅ 独立MCP服务器管理
• ✅ 带键盘导航的交互式TUI
• ✅ 自动备份功能

繁体中文

一个用于管理 双子座 扩充功能和MCP (Model Context Protocol) 服务器的文字界面（TUI）工具。

功能特色

• 🎯 扩充功能管理：启用/停用Geminicli 扩充功能
• 🔌 扩充功能内的MCP 服务器管理：控制扩充功能内的MCP 服务器
• 🌐 独立MCP 服务器管理：管理 settings.json 中的独立MCP 服务器
• 🎨 互动式TUI：易于使用的终端界面，支持键盘导航
• 💾 自动备份：储存前自动备份设定档
• ⚡ 快速且轻量：使用React Ink 打造流畅的终端渲染

画面截图

安装

前置需求

• Node.js>=18.0.0
• 已安装并设定好 双子座

从npm 安装（推荐）

npm install -g geminicli-manage-addon

从原始码安装

git clone https://github.com/castle-studio-work/geminicli-manage-addon.git
cd geminicli-manage-addon
npm install
npm link

使用方式

执行TUI

geminicli-manage-addon

键盘控制

与Geminicli 整合

您也可以使用 /manage-addon 斜线指令直接从Geminicli 执行此工具：

1. 建立 ~/.gemini/commands/manage-addon.toml：

description = "Manage extensions and MCP servers"

prompt = """
I will launch the Geminicli Addon Manager TUI tool for you.

IMPORTANT INSTRUCTIONS:
1. Use Ctrl+F to interact with the TUI tool (arrow keys, space, enter)
2. After making changes, you MUST restart Gemini CLI for the new settings to take effect

Running the tool now...

Execute: `geminicli-manage-addon`

After you finish:
- Press Enter to save and exit
- Press Esc to exit without saving
- Then restart Gemini CLI to apply the changes
"""

2. 在Geminicli 中输入：

/manage-addon

3. 重要：按 Ctrl+F 来操作TUI

4. 完成变更后：重新启动Gemini CLI 以套用新设定

设定档

此工具管理以下设定档：

所有档案在储存前都会自动备份为 .bak 扩展名。

运作原理

扩充功能管理

扩充功能透过修改 extension-enablement.json 中的 overrides 数组来启用/停用：

• 启用：["/Users/username/*"]
• 停用：["!/Users/username/*"]

扩充功能内的MCP 服务器

扩充功能内的MCP 服务器透过 mcp-server-enablement.json 管理：

{
  "github": {
    "github": true
  },
  "chrome-devtools-mcp": {
    "chrome-devtools": false
  }
}

独立MCP 服务器

独立MCP 服务器（定义在 settings.json 中）透过 mcp.excluded 数组管理：

{
  "mcp": {
    "excluded": ["pointer", "context7", "deepwiki"]
  }
}

开发

设定

git clone https://github.com/castle-studio-work/geminicli-manage-addon.git
cd geminicli-manage-addon
npm install

本地执行

npm start

项目结构

geminicli-manage-addon/
├── index.js          # 入口點
├── ui.js             # TUI 邏輯和元件
├── package.json      # 專案設定
└── README.md         # 本檔案

技术细节

• 框架：墨水 - CLI 的 React
• 语言：ES6模块（Node.js）
• 相容性：Node.js v18+（已在v25.2.1 测试）
• 不使用 JSX：使用 React.createElement 以达到最大兼容性

故障排除

找不到指令

如果安装后找不到 geminicli-manage-addon：

1. 检查npm 全局bin 目录：

   复制

   npm config get prefix
   

2. 确保bin 目录在您的PATH 中：

   复制

   export PATH="$(npm config get prefix)/bin:$PATH"
   

权限错误

如果储存时遇到权限错误：

# 檢查檔案權限
ls -la ~/.gemini/extensions/extension-enablement.json
ls -la ~/.gemini/settings.json

# 如需修正
chmod 644 ~/.gemini/extensions/extension-enablement.json
chmod 644 ~/.gemini/settings.json

贡献

欢迎贡献！请随时提交Pull Request。

1. Fork 此储存库
2. 建立您的功能分支 (git checkout -b feature/AmazingFeature)
3. 提交您的变更（git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启Pull Request

授权条款

本项目采用MIT 授权条款-详见 许可证 档案。

致谢

• 为 双子座 打造
• 由 墨水 驱动
• 灵感来自于更简便的Geminicli 设定管理需求

支援

如果您遇到任何问题或有疑问：

• 🐛 回报错误
• 💡 请求功能
• 📖 阅读文件

更新日志

v1.0.0（2025-11-30）

• ✨ 首次发布
• ✅ 扩充功能管理
• ✅ 扩充功能内的MCP 服务器管理
• ✅ 独立MCP 服务器管理
• ✅ 互动式TUI 与键盘导航
• ✅ 自动备份功能

由...制作❤️ 为Geminicli社区