Content
# AI Toolkit
<div align="center">
[](https://github.com)
[](https://github.com)
[](https://tauri.app/)
English
</div>
## 📖 Introduction
AI Toolkit is a **universal AI programming tool management tool** that supports unified management of MCP server configuration and Skills synchronization. Say goodbye to tedious manual editing, and manage all AI CLI tool plug-in services with one application.
## ✨ Core Features
### 🎯 MCP Server Management
- Supports **14** mainstream AI programming tools: Qwen Code, Claude Code, Codex, Gemini CLI, OpenCode, TRAE IDE, TRAE IDE CN, TRAE Work, TRAE Work CN, Qoder, Qoder CLI, CodeBuddy, Hermes Agent, Mimo Code
- Add, edit, and delete MCP servers in a single interface
- Automatically detect installed AI tools in the system and pop up prompts when new tools are discovered
- Switch toggle to **real-time synchronization** to the corresponding tool's configuration file
- **JSON paste mode**: directly copy the JSON configuration from the MCP introduction page, paste and recognize
- **Batch import preview**: paste multiple MCP Server configurations at once, select and import in batches
- **Connection test**: built-in test connection function to ensure the server configuration is valid before saving
### 🧰 Skills Management
- **Skills panel**: independent Skills management interface, centralized management of all installed skills
- **Installation location switching**: support switching the central Skills directory between official `~/.agents/skills/` and `~/.ai-toolkit/skills/`
- **Batch synchronization**: support selecting multiple Skills in the pop-up window, synchronizing to multiple target tools
- **Git installation**: support installing Skills from GitHub/GitLab repository, automatically parsing repository structure
- **Online search**: search popular Skills from skills.sh
- **Featured recommendations**: browse featured Skills list, including installation volume and star information
- **One-click update**: automatically detect updated Skills, support fast update
- **Health check and deletion preview**: check Skills documents, paths, synchronization target status, preview impact range before deletion
- **Synchronization progress and conflict strategy**: batch synchronization display itemized progress, support renaming, skipping or overwriting when installing/renaming duplicate skills
### 🛡️ Enhancement Center
- **MCP and tool configuration file snapshot**: backup MCP Server data and each tool's MCP configuration file, support one-click recovery
- **Health check**: detect MCP commands, environment variables, configuration files, and synchronization status
- **Configuration compression package import and export**: export MCP, Skills files, and settings as `.zip`, avoid large file content stuffed into the page
- **Task log**: record tool installation, update, scan, Skills synchronization, and import operation results
- **Agent startup preset**: save tool, working directory, and MCP combination, start with one click
### 🔧 Developer Friendly
- Click the tool name to quickly open the corresponding configuration file
- Visual interface, goodbye to manual editing of JSON/TOML files
- Support automatic recognition of multiple configuration file paths
- **Atomic write**: temporary file + rename mechanism to prevent configuration damage
- **Code quality inspection**: add `pnpm lint` / `pnpm check`, use Oxlint and TypeScript to uniformly inspect front-end code
### 🚀 Agent Quick Launch
- **One-click launch**: directly launch AI tools from the terminal
- **Terminal preference**: support selecting default launch terminal in settings (macOS: Terminal / iTerm / Warp / Ghostty; Windows: Windows Terminal / PowerShell / Command Prompt)
### 📦 Tool Management
- **Installation wizard**: display various installation methods for each tool (Homebrew, npm, curl script)
- **CLI / desktop client recognition**: detect CLI and desktop client simultaneously, support OpenCode, Claude Code, Codex and other tools to start separately
- **Version detection**: automatically detect CLI version and desktop client version
- **One-click update**: CLI update goes through the package manager, desktop client update opens the official update page
- **Usage documentation**: each tool card provides official documentation entry for quick reference
- **Concurrent update**: support multiple tools to update simultaneously, and display update progress independently
### 🔄 Application Update and Sharing
- **Startup check update**: automatically detect new versions when opening for the first time, pop up prompts if there is an update, and let the user decide whether to install
- **One-click sharing**: copy the official site address in the settings page, convenient for sharing with other users
## 📸 Interface Preview
### Main Interface
## 🖥️ System Support
| System | Status | Description |
|------|------|------|
| **macOS 12+** | ✅ Supported | Complete function support |
| **Linux** | 🚧 In development | Basic functions available |
| **Windows 10+** | ✅ Supported | MCP, Skills, tool launch, and terminal preference supported |
## 🚀 Quick Start
### macOS Installation
Download the latest `AI Toolkit_x.x.x_aarch64.dmg` installation package from the [Releases](https://github.com/whyfail/ai-toolkit/releases) page:
```bash
# Mount DMG
hdiutil attach AI\ Toolkit_*.dmg
# Drag to Applications folder
cp -R /Volumes/AI\ Toolkit/AI\ Toolkit.app /Applications/
```
### ⚠️ macOS Security Prompt (must-read for first run)
Due to the current version not being Apple code-signed and notarized, macOS security mechanisms may intercept unsigned applications, prompting **"Unable to verify developer"** or **"File damaged"**. Please follow the steps below to allow:
**Method 1 (Terminal command - most recommended):**
1. Drag the application to the `/Applications` folder
2. Open **Terminal**, execute the following command:
```bash
sudo xattr -cr "/Applications/AI Toolkit.app"
```
3. Enter the boot password and press Enter (password input is not displayed), and you can open it after the prompt is successful
**Method 2 (right-click to open):**
1. Find `AI Toolkit.app` in **Finder**
2. **Right-click** (or press and hold the `Control` key and click) the application icon
3. Select **"Open"** in the pop-up menu
4. In the system warning box that pops up, click **"Open"** again
**Method 3 (system settings allow):**
1. Open **"System Settings"** -> **"Privacy & Security"**
2. Scroll down to the **"Security"** area
3. Find the prompt `"AI Toolkit" blocked use...`
4. Click **"Still open"**, enter the password to confirm
## 📁 Supported AI Tools and Configuration Paths
| Tool | Configuration file path |
|------|-------------|
| Qwen Code | `~/.qwen/settings.json` |
| Claude Code | `~/.claude.json` |
| OpenAI Codex | `~/.codex/config.toml` |
| Google Gemini CLI | `~/.gemini/settings.json` |
| OpenCode | `~/.config/opencode/opencode.json` |
| Qoder | `~/Library/Application Support/Qoder/SharedClientCache/mcp.json` |
| Qoder CLI | `~/.qodercli/settings.json` |
| TRAE IDE | `~/Library/Application Support/Trae/User/mcp.json` |
| TRAE IDE CN | `~/Library/Application Support/Trae CN/User/mcp.json` |
| TRAE Work | `~/Library/Application Support/TRAE Work/User/mcp.json` |
| TRAE Work CN | `~/Library/Application Support/TRAE Work CN/User/mcp.json` (compatible with old `TRAE SOLO CN` path) |
| CodeBuddy | `~/.codebuddy/mcp.json` |
| Hermes Agent | `~/.hermes/config.yaml` |
| Mimo Code | `~/.config/mimocode/mimocode.json` |
## 🛠️ Technical Stack
- **Front-end**: React 18 · TypeScript · Vite · TailwindCSS · TanStack Query
- **Back-end**: Tauri 2 · Rust · SQLite (rusqlite)
## 📄 License
MIT License
---
<div align="center">
<p>Made with ❤️ for AI Developers</p>
</div>
