mcp-config-manager 2.1.0 → 2.3.0

package/README.md

@@ -24,6 +24,29 @@ Simple CLI and web UI tool to manage Model Context Protocol (MCP) configurations
 - **Cross-platform**: Works on macOS, Windows, and Linux
 - **Import/Export**: Share configurations between clients and users
 - **Environment variables**: Easily manage API keys and settings
+- **Per-Client Skills/Prompts/Rules**: Manage AI assistant customizations for 25+ clients
+  - **Claude Code/Desktop**: Skills, Commands, and Agents (`~/.claude/skills/`, `commands/`, `agents/`)
+  - **Cursor**: Rules (`~/.cursor/rules/`) in MDC format
+  - **Continue.dev**: Prompts (`~/.continue/prompts/`) and Rules (`~/.continue/rules/`)
+  - **Windsurf**: Rules (`~/.codeium/windsurf/memories/global_rules.md`)
+  - **GitHub Copilot**: Instructions and Skills (`~/.github/copilot-instructions.md`, `~/.copilot/skills/`)
+  - **Amazon Q**: Rules (`~/.aws/amazonq/rules/`)
+  - **Cline**: Rules (`~/Documents/Cline/Rules/`)
+  - **Roo Code**: Rules (`~/.roo/rules/`)
+  - **Gemini CLI**: Context, Commands, and Skills (`~/.gemini/GEMINI.md`, `commands/`, `skills/`)
+  - **Codex**: Agents (`~/.codex/AGENTS.md`) and Skills (`~/.codex/skills/`)
+  - **Mistral Vibe**: Skills and Agents (`~/.vibe/skills/`, `~/.vibe/agents/`)
+  - **Amp**: Skills (`~/.config/agents/skills/`)
+  - **Goose**: Skills (`~/.config/goose/skills/`)
+  - **OpenCode**: Skills (`~/.config/opencode/skills/`)
+  - **Firebender**: Rules (`~/.firebender/rules/`)
+  - **Autohand Code CLI**: Skills (`~/.autohand/skills/`)
+  - **pi**: Skills (`~/.pi/agent/skills/`)
+  - **Augment Code**: Commands and Rules (`~/.augment/commands/`, `rules/`)
+  - **Aider**: Config (`~/.aider.conf.yml`)
+  - And more: JetBrains AI, Tabnine, Piebald, TRAE, Letta, Qodo, VT Code, and others
+- **Simple & Complex Skills**: Single-file skills and directory-based skills with workflows, references
+- **Tab-Based UI**: Each client shows relevant tabs (Servers, Skills, Commands, Rules, Agents, etc.)
 
 ## Screenshots
 
@@ -107,6 +130,8 @@ npm run web
 
 **Note:** `mcp-manager` also works as a shorter alias for `mcp-config-manager`.
 
+**Note:** Skills and commands management is available through the web UI. Use `mcp-config-manager web` to access the skills and commands management interface.
+
 ### Web UI
 
 **Start the web server:**
@@ -177,23 +202,105 @@ The web UI provides:
 - Add/edit/delete servers
 - Import/export configurations
 - Environment variable management
+- **Per-Client Skills/Rules Mode**: Each client shows relevant tabs for its customization types
+  - Create, edit, and delete skills, rules, commands, prompts, and more
+  - Manage per-client customizations (skills for Claude, rules for Cursor, etc.)
+  - View and manage directory-based skill file trees
+
+## Skills & Customization Management
+
+The tool includes full support for managing per-client AI assistant customizations alongside MCP server configurations. Each client has its own tabs for managing skills, commands, rules, prompts, or other customization types.
+
+### Per-Client Tabs
+
+Different clients support different types of customizations:
+
+| Client | Tabs |
+|--------|------|
+| Claude Code/Desktop | Skills, Commands, Agents |
+| Cursor | Rules (MDC format) |
+| Continue.dev | Prompts, Rules |
+| Windsurf | Rules |
+| GitHub Copilot | Instructions, Skills |
+| Amazon Q | Rules |
+| Cline | Rules |
+| Roo Code | Rules |
+| Gemini CLI | Context, Commands, Skills |
+| Codex | Agents, Skills |
+| Mistral Vibe | Skills, Agents |
+| Amp (Sourcegraph) | Skills |
+| Goose (Block) | Skills |
+| OpenCode | Skills |
+| Firebender | Rules (MDC format) |
+| Autohand Code CLI | Skills |
+| pi | Skills |
+| Piebald | Skills, Agents |
+| JetBrains AI | Rules |
+| Augment Code | Commands, Rules |
+| Tabnine | Guidelines |
+| Aider | Config |
+
+### Using the Web UI
+
+1. **Select a client**: Each client card shows its available tabs (Servers, Skills, Commands, Rules, etc.)
+2. **Switch tabs**: Click a tab to view and manage that type of content
+3. **Create new items**: Click "Add" to create new skills, rules, commands, etc.
+4. **Edit existing**: Click on any item card to edit its content
+5. **Manage files**: For complex/directory-based skills, view and manage associated file trees
+6. **Copy items**: Duplicate items within the same tab
+
+### Skill File Structure (Claude Code)
+
+```markdown
+---
+name: my-skill
+description: A helpful skill description
+---
+
+# My Skill
+
+Instructions and content for the skill...
+```
 
 ## Supported Clients
 
 This tool supports auto-detection of any client that follows the Model Context Protocol specification. The following is a non-exhaustive list of clients that have been tested and are known to work:
 
+- **Aider**: Config management (`~/.aider.conf.yml`)
+- **Agentman**: Registered (no confirmed global paths)
 - **Amazon Q Developer**: `~/.aws/amazonq/mcp.json`
+- **Amp** (Sourcegraph): Skills (`~/.config/agents/skills/`)
+- **Augment Code**: Commands (`~/.augment/commands/`) and Rules (`~/.augment/rules/`)
+- **Autohand Code CLI**: Skills (`~/.autohand/skills/`)
 - **Claude Desktop**: `~/Library/Application Support/Claude/claude_desktop_config.json`
 - **Claude Code**: `~/.claude.json` (global settings and MCP servers)
 - **Cline**: `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
 - **Codex**: `~/.codex/config.toml` (TOML with `[mcp_servers.<name>]` tables)
+- **Command Code**: Registered (no confirmed global paths)
 - **Cursor**: `.cursor/mcp.json` (project-specific) or `~/.cursor/mcp.json` (global)
+- **Databricks**: Workspace-level skills support
 - **Factory Bridge**: `~/Library/Application Support/Factory Bridge/mcp.json`
+- **Firebender**: Rules (`~/.firebender/rules/*.mdc`)
 - **Gemini**: `~/.gemini/settings.json`
 - **Google AntiGravity**: `~/.gemini/antigravity/mcp_config.json`
+- **Goose** (Block): Skills (`~/.config/goose/skills/`)
+- **JetBrains AI Assistant**: `~/.aiassistant/rules/` (rules management)
+- **Letta Code**: Project-level skills support
+- **Mistral Vibe**: Skills (`~/.vibe/skills/`) and Agents (`~/.vibe/agents/`)
+- **Mux**: Registered (no confirmed global paths)
+- **Ona**: Cloud-based AI software engineers
+- **OpenCode**: Skills (`~/.config/opencode/skills/`)
+- **pi**: Skills (`~/.pi/agent/skills/`)
+- **Piebald**: Uses Claude Code paths (desktop app wrapper)
+- **Qodo**: Registered (TOML-based agent configs)
 - **Roo Code**: `~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json`
+- **Spring AI**: Library-level skills integration
+- **Tabnine**: `~/.tabnine/guidelines/` (guidelines management)
+- **TRAE** (ByteDance): Project-level rules support
 - **VS Code**: `.vscode/mcp.json`
+- **VT Code**: Follows Agent Skills standard
 - **Windsurf**: `~/.codeium/windsurf/mcp_config.json` or `~/AppData/Roaming/WindSurf/mcp_settings.json` (Windows)
+- **Zed AI**: Project-root `.rules` file for per-project configuration
 
 *Note: Paths may vary based on your operating system. The tool will attempt to find the correct path automatically.*
 
@@ -244,6 +351,51 @@ url = "https://mcp.figma.com/mcp"
 bearer_token_env_var = "FIGMA_OAUTH_TOKEN"
 ```
 
+## API Reference
+
+The web UI communicates with the server via REST API endpoints. These can also be used for automation and integration.
+
+### MCP Server Endpoints
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/clients` | List all detected clients |
+| GET | `/api/clients/:client/servers` | List servers for a client |
+| POST | `/api/clients/:client/servers/:server` | Create a server |
+| PUT | `/api/clients/:client/servers/:server` | Update a server |
+| DELETE | `/api/clients/:client/servers/:server` | Delete a server |
+| POST | `/api/clients/:client/servers/:server/copy` | Copy server to other clients |
+| POST | `/api/clients/:client/import` | Import configuration |
+| GET | `/api/clients/:client/export` | Export configuration |
+
+### Per-Client Skills/Prompts/Rules Endpoints
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/clients/:client/tabs` | List skill tabs for client |
+| GET | `/api/clients/:client/has-skills` | Check if client supports skills |
+| GET | `/api/clients/:client/tabs/:tab/items` | List items in tab |
+| GET | `/api/clients/:client/tabs/:tab/items/:name` | Read item |
+| POST | `/api/clients/:client/tabs/:tab/items/:name` | Create item |
+| PUT | `/api/clients/:client/tabs/:tab/items/:name` | Update item |
+| DELETE | `/api/clients/:client/tabs/:tab/items/:name` | Delete item |
+| GET | `/api/clients/:client/tabs/:tab/items/:name/files` | List files in complex item |
+| GET | `/api/clients/:client/tabs/:tab/items/:name/files/*path` | Read file |
+| PUT | `/api/clients/:client/tabs/:tab/items/:name/files/*path` | Write file |
+| POST | `/api/clients/:client/tabs/:tab/items/:name/copy` | Copy item |
+
+### Commands Endpoints
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/commands` | List all commands |
+| GET | `/api/commands/:name` | Read command |
+| POST | `/api/commands/:name` | Create command |
+| PUT | `/api/commands/:name` | Update command |
+| DELETE | `/api/commands/:name` | Delete command |
+| POST | `/api/commands/:name/rename` | Rename command |
+| POST | `/api/commands/:name/duplicate` | Duplicate command |
+
 ## Security Note
 
 Environment variables may contain sensitive data like API keys. The tool masks values containing "KEY" or "SECRET" in the display but stores them in plain text in config files.
@@ -336,6 +488,59 @@ npm run web
 
 This allows testing functionality without affecting real MCP client configurations.
 
+## What's New in v2.3.0
+
+### 20 New Clients with Skills Support
+- **Firebender**: Rules in MDC format (`~/.firebender/rules/`)
+- **Goose** (Block): Skills (`~/.config/goose/skills/`)
+- **Amp** (Sourcegraph): Skills (`~/.config/agents/skills/`)
+- **OpenCode**: Skills (`~/.config/opencode/skills/`)
+- **Mistral Vibe**: Skills and Agents (`~/.vibe/skills/`, `~/.vibe/agents/`)
+- **pi**: Skills (`~/.pi/agent/skills/`)
+- **Autohand Code CLI**: Skills (`~/.autohand/skills/`)
+- **Piebald**: Uses Claude Code paths
+- **TRAE, Letta, Qodo, VT Code, Command Code, Ona, Agentman, Mux, Spring AI, Databricks**: Registered with placeholder support
+
+### New Tabs for Existing Clients
+- **Claude Code/Desktop**: Added Agents tab (`~/.claude/agents/`)
+- **Gemini CLI/AntiGravity**: Added Skills tab (`~/.gemini/skills/`)
+- **GitHub Copilot**: Added Skills tab (`~/.copilot/skills/`)
+- **Augment Code**: Added Commands tab (`~/.augment/commands/`)
+- **Aider**: Added Config tab (`~/.aider.conf.yml`)
+
+### UI Improvements
+- Widened Edit Skill modal from 900px to 1200px for better file tree + editor layout
+- Fixed dead CSS selector for skill modal content
+
+### Total: 38 clients registered, 25 with active skills/rules support
+
+---
+
+## What's New in v2.2.0
+
+### Per-Client Skills/Prompts/Rules Management
+- **Per-client architecture**: Each client now has its own skills, prompts, rules, or commands tabs based on what it supports
+- **Tab-based UI**: Client cards show relevant tabs (Servers, Skills, Commands, Rules, etc.) depending on the client
+- **Complex skills**: Full support for directory-based skills with file trees and multiple associated files
+- **New API endpoints**: Complete REST API for per-client tab items and file management
+
+### Security Hardening
+- Input validation and path traversal protection for skills/rules file operations
+- Sanitized file names and directory paths
+
+### CSS Fixes
+- Improved dark mode styling for skills/rules tabs
+- Fixed tab layout and spacing across views
+
+---
+
+## What's New in v2.1.1
+
+### Bug Fix
+- **Codex format delete fix**: Server deletion now works correctly for Codex TOML configs (previously deleted servers would reappear due to incorrect object spread in denormalizeConfig)
+
+---
+
 ## What's New in v2.1.0
 
 ### Custom Icon Editing
@@ -382,6 +587,7 @@ All servers now automatically display logos:
 ### Bug Fixes
 - Fixed server deletion in Server View (was prompting twice but not deleting)
 - Improved event handling reliability
+- **Fixed Codex format delete bug**: Server deletion now works correctly for Codex TOML configs (previously deleted servers would reappear)
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-config-manager",
-  "version": "2.1.0",
+  "version": "2.3.0",
   "description": "Simple CLI and web UI to manage MCP configs across multiple AI clients",
   "main": "src/cli.js",
   "bin": {

package/public/index.html

@@ -97,6 +97,7 @@
             </div>
             <div class="server-list-all" id="allServersList"></div>
         </div>
+
     </div>
 
     <!-- Add/Edit Server Modal -->
@@ -411,13 +412,108 @@
         </div>
     </div>
 
+    <!-- Skill/Item Edit Modal -->
+    <div id="skill-modal" class="modal" style="display: none;">
+      <div class="modal-content modal-large" id="skill-modal-content">
+        <h3 id="skill-modal-title">Edit Item</h3>
+
+        <!-- Simple skill view: metadata + content in one pane -->
+        <div id="skill-simple-view">
+          <form id="skill-form-simple">
+            <div class="skill-metadata-row">
+              <div class="form-group form-group-name">
+                <label for="skill-name">Name</label>
+                <input type="text" id="skill-name" name="name" required placeholder="my-skill">
+              </div>
+              <div class="form-group form-group-model">
+                <label for="skill-model">Model</label>
+                <input type="text" id="skill-model" name="model" placeholder="claude-3-opus">
+              </div>
+            </div>
+            <div class="form-group">
+              <label for="skill-description">Description</label>
+              <input type="text" id="skill-description" name="description" placeholder="What this skill does">
+            </div>
+            <div class="form-group">
+              <label for="skill-content">Content</label>
+              <textarea id="skill-content" name="content" rows="16" class="skill-content-editor" placeholder="Your skill instructions here..."></textarea>
+            </div>
+            <div class="modal-actions">
+              <button type="button" id="skill-cancel-btn" class="btn btn-secondary">Cancel</button>
+              <button type="submit" class="btn btn-primary">Save</button>
+            </div>
+          </form>
+        </div>
+
+        <!-- Complex skill view: file tree + editor -->
+        <div id="skill-complex-view" style="display: none;">
+          <div class="skill-complex-layout">
+            <div class="skill-file-tree">
+              <div class="file-tree-header">
+                <span class="file-tree-title">Files</span>
+              </div>
+              <div id="skill-file-list" class="file-list"></div>
+            </div>
+            <div class="skill-editor-pane">
+              <div class="editor-header">
+                <span id="skill-current-file">SKILL.md</span>
+                <button type="button" id="skill-save-file-btn" class="btn btn-small btn-primary">Save File</button>
+              </div>
+              <textarea id="skill-file-editor" class="skill-content-editor" rows="20"></textarea>
+            </div>
+          </div>
+          <div class="modal-actions">
+            <button type="button" id="skill-complex-cancel-btn" class="btn btn-secondary">Close</button>
+          </div>
+        </div>
+      </div>
+    </div>
+
+    <!-- Command Modal -->
+    <div id="command-modal" class="modal" style="display: none;">
+      <div class="modal-content">
+        <div class="modal-header">
+          <h2 id="command-modal-title">Add Command</h2>
+          <button class="close-btn" onclick="document.getElementById('command-modal').style.display='none'">&times;</button>
+        </div>
+        <form id="command-form">
+          <div class="form-group">
+            <label for="command-name">Command Name</label>
+            <input type="text" id="command-name" name="name" required placeholder="my-command" pattern="[a-z0-9-]+" title="Lowercase letters, numbers, and hyphens only">
+            <small class="form-hint">Will be invoked as /command-name</small>
+          </div>
+          <div class="form-group">
+            <label for="command-description">Description</label>
+            <input type="text" id="command-description" name="description" placeholder="What this command does">
+          </div>
+          <div class="form-group">
+            <label for="command-tools">Tools (comma-separated)</label>
+            <input type="text" id="command-tools" name="tools" placeholder="git, Read, Bash">
+          </div>
+          <div class="form-group">
+            <label for="command-content">Prompt Content</label>
+            <textarea id="command-content" name="content" rows="12" placeholder="The prompt expansion for this command..."></textarea>
+          </div>
+          <div class="form-actions">
+            <button type="button" id="command-cancel-btn" class="btn-secondary">Cancel</button>
+            <button type="submit" class="btn-primary">Save Command</button>
+          </div>
+        </form>
+        <div id="command-loading" class="loading-overlay" style="display: none;">
+          <div class="spinner"></div>
+        </div>
+      </div>
+    </div>
+
     <script type="module" src="js/utils.js?v=4"></script>
     <script type="module" src="js/api.js?v=4"></script>
     <script type="module" src="js/modals.js?v=4"></script>
-    <script type="module" src="js/clientView.js?v=4"></script>
+    <script type="module" src="js/clientView.js?v=6"></script>
     <script type="module" src="js/kanbanView.js?v=4"></script>
     <script type="module" src="js/serverView.js?v=4"></script>
     <script type="module" src="js/popularMcps.js?v=4"></script>
-    <script type="module" src="js/main.js?v=4"></script>
+    <script type="module" src="js/skillsApi.js?v=7"></script>
+    <script type="module" src="js/main.js?v=6"></script>
+    <div class="version-tag">v2.3.0</div>
 </body>
 </html>