Personal AI Toolbox - All-in-one management for your AI coding assistant configurations

English | 简体中文

关于语言： 根目录 README 以英文为主，是因为 AppImageHub 等应用目录要求仓库 README 使用英文，中文为主会导致收录失败。完整的中文文档见 README.zh-CN.md。

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.

• 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

OpenCode and Oh My OpenAgent / Oh My OpenCode Slim plugin configuration management

Claude Code / Codex / MCP server management

Skills management / Settings page / WSL sync

Head to the Releases page and download the installer for your system:

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.

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

• Node.js 20.19+ or 22.12+
• pnpm 9+
• Rust 1.90+
• See the Tauri prerequisites

pnpm install

pnpm tauri dev

pnpm tauri build

# TypeScript type checking
pnpm tsc --noEmit

# Rust checks
cd tauri && cargo check

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.

• 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

The following 3 tables use regular columns instead of JSONB:

Issues and pull requests are welcome!

1. Fork this repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a pull request

• VS Code
• Tauri extension
• rust-analyzer

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.

• skills-hub — MIT
• cc-switch — MIT
• skills-manager — MIT
• linux.do
• axonhub — Apache-2.0 (its llm/ directory is LGPL-3.0, see NOTICE)