AI Toolbox
关于语言： 根目录 README 以英文为主，是因为 AppImageHub 等应用目录要求仓库 README 使用英文，中文为主会导致收录失败。完整的中文文档见 README.zh-CN.md。
Introduction
AI Toolbox is a cross-platform desktop application that helps developers efficiently manage the configuration of AI coding assistants. It supports Windows, macOS, and Linux.
Features
- OpenCode configuration management - Visually manage OpenCode providers and models, with quick enable/disable toggles from the list view
- Oh My OpenAgent / Oh My OpenCode Slim plugin configuration - Visually manage the configuration of the Oh My OpenAgent and Oh My OpenCode Slim plugins
- Claude Code configuration management - Switch Claude Code between official subscription and custom API providers in one click, with dynamic model list fetching, global prompts, and plugin management
- Codex configuration management - Manage OpenAI Codex CLI official accounts/custom channels, model mappings, global prompts, plugins, and session history
- Grok CLI configuration management - Manage Grok CLI providers,
config.toml / auth.json, official accounts, global prompts, and plugins
- Gemini CLI configuration management - Manage Gemini CLI official accounts/custom channels,
.env / settings.json, global prompts, and usage information
- Kimi Code CLI configuration management - Manage Kimi Code CLI providers,
config.toml / credentials official accounts, global prompts, and plugins
- OpenClaw configuration management - Manage OpenClaw models, providers, config file paths, and session records
- Pi configuration management - Manage Pi CLI models, providers, extensions, prompts, and runtime configuration
- Oh My Pi configuration management - Manage the OMP runtime root,
models.yml providers, config.yml settings, and subagents. Local configuration and account metadata remain available offline; independent native model discovery cannot block opening or saving configuration. Codex subscriptions support native OMP login, private Codex CLI auth.json import (up to 256 KiB), and manual account switching. The list includes native-login and imported accounts from the selected runtime directory only; switching enables the selected account without deleting other credentials. Each account supports manual queries for remaining 5-hour and weekly quota and reset times; Pro subscriptions have no 5-hour limit. Quota queries are read-only, do not refresh tokens, and leave unknown or failed results unknown. No automatic switching, balancing, failover, or background quota polling is added. Tokens stay in agent.db, never YAML or shared exports; import checks structure, not session validity. Existing OMP sessions may need restarting after a switch. Account writes require native auth schema 8 (verified with OMP 18.8.7), and reject broker, WSL/UNC, or profile/XDG redirection. Login and native model discovery require omp login openai-codex and omp models --json. The native catalog is fetched on demand — by the page's first load and by the subscription card's refresh button — and cached, so routine config saves never run the CLI.
- Claude Desktop configuration management - Manage Claude Desktop 3P gateway profiles, with one-click gateway takeover
- Hermes Agent configuration management - Manage Hermes Agent's
config.yaml, providers, default model, global prompts, and memory files
- DeepSeek Harness configuration management - Manage DeepSeek Harness (dsh)
settings.yaml / .credentials.yaml, providers, default model, and global prompts
- Local proxy gateway - A unified local proxy endpoint with Claude Code / Claude Desktop / Codex / Grok / Kimi / Gemini CLI takeover, protocol conversion, failover, request logs, usage statistics, and model pricing management
- Image workbench - Manage image generation/editing channels, create image jobs, and keep history and generated assets
- MCP server management - Centrally manage MCP (Model Context Protocol) server configurations, with import/export, favorites, groups, and multi-tool sync
- Skills management - Manage a central Skills repository, install from Git repositories or local directories, enable/disable and sync per tool, plus custom tools and group management
- Session management - Browse, search, rename, import, export, and delete sessions for OpenCode / Claude Code / Codex / Grok / Gemini CLI / Kimi / OpenClaw / Pi / Oh My Pi / Claude Desktop / Hermes / DeepSeek Harness
- WSL sync - Sync the various CLI, MCP, and Skills configurations from Windows into a WSL environment, with automatic sync and custom mappings
- SSH sync - Sync local configurations, MCP, and Skills to remote SSH hosts, with connection management, path mappings, and manual sync
- Provider management - Unified management of multiple AI providers (OpenAI, Anthropic, custom proxies, etc.), with cross-coding-tool sharing and deep-link import
- System tray - Quickly toggle providers, models, prompts, MCP, and Skills for each module from the system tray, without opening the main window
- Data backup - Local backups, WebDAV cloud backups, GitHub/Gitee private repository backups, automatic backups, optional backup encryption (passwords stored in the local system credential store), custom backup items, image asset backups, and sensitive file filtering
- Theme switching - Light, dark, and follow-system themes
- Internationalization - Chinese and English interfaces
- Automatic update check - Checks for new versions on startup
Screenshots
Download and Installation
Head to the Releases page and download the installer for your system:
| Platform | Installer |
|---|
| Windows | .msi / .exe |
| macOS | .dmg |
| Linux | .deb / .AppImage |
On macOS you can also install, upgrade, and uninstall via Homebrew:
brew tap coulsontl/ai-toolbox https://github.com/coulsontl/ai-toolbox
brew install --cask coulsontl/ai-toolbox/ai-toolbox
sudo xattr -rd com.apple.quarantine /Applications/AI\ Toolbox.app
brew upgrade --cask coulsontl/ai-toolbox/ai-toolbox
brew uninstall --cask coulsontl/ai-toolbox/ai-toolbox
# Optional: remove this tap once you no longer need it
brew untap coulsontl/ai-toolbox
Notes:
- The Cask currently lives in this repository, so the first
brew tap must include the repository URL.
- After a new version is released,
Casks/ai-toolbox.rb in this repository is updated automatically by the release workflow, so brew upgrade picks up the new version.
On Windows you can also install, upgrade, and uninstall via Scoop:
scoop bucket add ai-toolbox https://github.com/coulsontl/ai-toolbox
scoop install ai-toolbox/ai-toolbox
# Upgrade: refresh the bucket to get the new manifest first, then upgrade the app
scoop update
scoop update ai-toolbox
scoop uninstall ai-toolbox
# Optional: remove this bucket once you no longer need it
scoop bucket rm ai-toolbox
Notes:
- The bucket currently lives in this repository, so the first
scoop bucket add must include the repository URL.
- After a new version is released,
bucket/ai-toolbox.json in this repository is updated automatically by the release workflow, so scoop update ai-toolbox picks up the new version.
- In-app auto-update is unavailable when the app is installed through Scoop; use
scoop update ai-toolbox to upgrade instead.
Tech Stack
| Category | Technology |
|---|
| Desktop framework | Tauri 2.x |
| Frontend | React 19 + TypeScript 5 |
| UI components | Ant Design 6 |
| State management | Zustand |
| Internationalization | i18next (Chinese/English) |
| Database | SQLite + JSONB |
| Build tool | Vite 7 |
| Package manager | pnpm |
Project Structure
ai-toolbox/
├── web/ # Frontend source
│ ├── app/ # Application layer (App, routing, providers)
│ ├── components/ # Shared components
│ │ └── layout/ # Layout components (MainLayout)
│ ├── features/ # Feature modules (grouped by domain)
│ │ ├── daily/ # 【Daily】 module
│ │ │ └── notes/ # Notes (Markdown)
│ │ ├── coding/ # 【Coding】 module
│ │ │ ├── opencode/ # OpenCode configuration (incl. Oh My OpenAgent / Oh My OpenCode Slim)
│ │ │ ├── claudecode/ # Claude Code configuration
│ │ │ ├── codex/ # Codex configuration
│ │ │ ├── grok/ # Grok CLI configuration
│ │ │ ├── geminicli/ # Gemini CLI configuration
│ │ │ ├── kimi/ # Kimi Code CLI configuration
│ │ │ ├── openclaw/ # OpenClaw configuration
│ │ │ ├── pi/ # Pi configuration
│ │ │ ├── oh_my_pi/ # Oh My Pi configuration
│ │ │ ├── claudedesktop/ # Claude Desktop configuration
│ │ │ ├── hermes/ # Hermes Agent configuration
│ │ │ ├── dsh/ # DeepSeek Harness configuration
│ │ │ ├── mcp/ # MCP server management
│ │ │ ├── skills/ # Skills management
│ │ │ ├── gateway/ # Local proxy gateway
│ │ │ ├── image/ # Image workbench
│ │ │ └── shared/ # Shared capabilities (providers, prompts, sessions, ...)
│ │ ├── shared/ # Capabilities shared across modules
│ │ │ └── deepLink/ # aitoolbox:// deep-link import and sharing
│ │ └── settings/ # 【Settings】 module
│ ├── stores/ # Global state (Zustand)
│ ├── services/ # API service layer
│ ├── i18n/ # Internationalization configuration
│ ├── constants/ # Constants (module configuration)
│ ├── hooks/ # Global hooks
│ ├── types/ # Global type definitions
│ └── utils/ # Utility functions
├── tauri/ # Tauri backend (Rust)
│ ├── src/
│ │ ├── main.rs # Entry point
│ │ ├── lib.rs # Library entry point, command registration
│ │ └── coding/ # Coding module
│ │ ├── claude_code/ # Claude Code backend
│ │ ├── codex/ # Codex backend
│ │ ├── open_code/ # OpenCode backend
│ │ ├── grok/ # Grok CLI backend
│ │ ├── gemini_cli/ # Gemini CLI backend
│ │ ├── kimi/ # Kimi Code CLI backend
│ │ ├── open_claw/ # OpenClaw backend
│ │ ├── pi/ # Pi backend
│ │ ├── oh_my_pi/ # Oh My Pi backend
│ │ ├── claude_desktop/ # Claude Desktop 3P configuration backend
│ │ ├── hermes/ # Hermes Agent backend
│ │ ├── dsh/ # DeepSeek Harness backend
│ │ ├── oh_my_openagent/ # Oh My OpenAgent backend
│ │ ├── oh_my_opencode_slim/ # Oh My OpenCode Slim backend
│ │ ├── mcp/ # MCP server backend
│ │ ├── skills/ # Skills backend
│ │ ├── tools/ # Shared tool adapters and detection
│ │ ├── proxy_gateway/ # Local proxy gateway backend
│ │ ├── image/ # Image jobs and assets backend
│ │ ├── session_manager/ # Session management backend
│ │ ├── deeplink/ # Deep-link parsing and import
│ │ ├── auth_refresh/ # Shared OAuth scheduling for official accounts
│ │ ├── ssh/ # SSH sync backend
│ │ └── wsl/ # WSL sync backend
│ ├── Cargo.toml # Rust dependencies
│ └── tauri.conf.json # Tauri configuration
├── package.json # Frontend dependencies
├── vite.config.ts # Vite configuration
└── tsconfig.json # TypeScript configuration
Development Guide
Prerequisites
Install dependencies
pnpm install
Start the development server
pnpm tauri dev
Build for production
pnpm tauri build
Linting and checks
# TypeScript type checking
pnpm tsc --noEmit
# Rust checks
cd tauri && cargo check
Feature Modules
| Module | Submodule | Status | Description |
|---|
| Coding | OpenCode | ✅ Done | OpenCode provider/model configuration, including Oh My OpenAgent / Oh My OpenCode Slim plugin configuration |
| Coding | Claude Code | ✅ Done | Claude Code official subscription/custom API configuration switching, with prompts, plugins, and session management |
| Coding | Codex | ✅ Done | OpenAI Codex CLI official account/custom channel management, with model mappings, prompts, plugins, and session management |
| Coding | Grok | ✅ Done | Grok CLI providers, config.toml / auth.json, official accounts, prompts, plugins, and session management |
| Coding | Gemini CLI | ✅ Done | Gemini CLI official accounts/custom channels, prompts, usage, and session management |
| Coding | Kimi | ✅ Done | Kimi Code CLI providers, config.toml / credentials official accounts, prompts, plugins, MCP/Skills, and session management |
| Coding | OpenClaw | ✅ Done | OpenClaw models, providers, configuration files, and session management |
| Coding | Pi | ✅ Done | Pi CLI models, providers, extensions, prompts, and session management |
| Coding | Oh My Pi | ✅ Done | Oh My Pi (OMP) runtime root, models.yml providers, config.yml settings, subagent configuration, and session management |
| Coding | Claude Desktop | ✅ Done | Claude Desktop 3P gateway profile configuration, with gateway takeover and session management |
| Coding | Hermes | ✅ Done | Hermes Agent config.yaml, providers, default model, global prompts, memory, and session management |
| Coding | DeepSeek Harness | ✅ Done | DeepSeek Harness (dsh) settings.yaml / .credentials.yaml, providers, default model, global prompts, and session management |
| Coding | Gateway | ✅ Done | Local proxy gateway, CLI takeover, protocol conversion, failover, request logs, and usage statistics |
Data Storage
SQLite is the local primary database, with per-module configuration stored in JSONB tables. A small number of structured tables (gateway request logs, daily usage rollups, model pricing) use regular columns instead, which keeps aggregation queries and indexes efficient.
Design Principles
- Local-first: All data is stored locally to protect privacy
- Service-layer API: The frontend talks to the backend through the service layer and does not use localStorage directly
- Flexible backup: Local ZIP, WebDAV cloud backup, automatic backup, custom backup items, and external configuration file backups
Tables
| Table | Description |
|---|
settings | Application settings |
app_migration | Internal application migration records |
opencode_common_config | OpenCode common configuration |
opencode_prompt_config | OpenCode prompt configuration |
opencode_favorite_provider | OpenCode favorite providers |
opencode_favorite_plugin | OpenCode favorite plugins |
claude_provider | Claude Code provider configuration |
claude_common_config | Claude Code common configuration |
claude_prompt_config | Claude Code prompt configuration |
codex_provider | Codex provider configuration |
codex_common_config | Codex common configuration |
codex_prompt_config | Codex prompt configuration |
codex_official_account | Codex official account configuration |
codex_plugin_workspace_roots | Codex plugin workspace roots |
grok_provider | Grok CLI provider configuration |
grok_official_account | Grok CLI official account configuration |
grok_common_config | Grok CLI common configuration |
grok_prompt_config | Grok CLI prompt configuration |
kimi_provider | Kimi Code CLI provider configuration |
kimi_official_account | Kimi Code CLI official account configuration |
kimi_common_config | Kimi Code CLI common configuration |
kimi_prompt_config | Kimi Code CLI prompt configuration |
gemini_cli_provider | Gemini CLI provider configuration |
gemini_cli_common_config |
The following 3 tables use regular columns instead of JSONB:
| Table | Description |
|---|
proxy_request_logs | Gateway request log details (tokens, cost, latency) |
usage_daily_rollups | Gateway usage statistics aggregated by day |
model_pricing | Model pricing table |
Contributing
Issues and pull requests are welcome!
- Fork this repository
- Create a feature branch (
git checkout -b feature/amazing-feature)
- Commit your changes (
git commit -m 'Add some amazing feature')
- Push to the branch (
git push origin feature/amazing-feature)
- Open a pull request
Recommended IDE Setup
License
AGPL-3.0-or-later © 2026 coulsontl
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the LICENSE for more details.
Because this project is licensed under AGPL-3.0, users who interact with the program over a computer network are likewise entitled to receive its source code. This repository is the complete corresponding source, and the source for each release corresponds to the same tag.
Acknowledgments
