mrkeyoor.com_
Sat 05 Sept 15:49 UTC
Dev Toolsevaluationupdated 05 Sept 2026

ai-toolbox review

AI Toolbox is a cross-platform desktop control panel for provider, model, prompt, session, MCP, skill, and gateway settings across coding assistants such as Claude Code, Codex, Gemini CLI, and OpenCode. Its main README and supporting docs are primarily Chinese, with no separate English README, although the application lists Chinese and English interface options. It replaces scattered configuration files and manual copying with one local database and synchronization layer.

Verdict

Our AI Toolbox run installed 785 packages and used 818 MB, then passed its 71-second build and 21-second test step. Use it if one technical user actively manages several coding agents and can audit the configuration changes it writes. English-only teams, shared gateway operators, and organizations with strict credential boundaries should choose narrower tools with a smaller trust surface.

We ran it

Lab card: what happened when we ran ai-toolboxScreenshot of ai-toolbox (github.com/coulsontl/ai-toolbox)
Install✓ · 37s785 packages · 818 MB
Build✓ · 71s
Tests✓ · 21sran, no count parsed
Repo1198 files~359,607 lines of source · 22.7 MB · 1 CI workflows

Answers from our run

Does ai-toolbox build from source?

Dependencies installed in 37 seconds (785 packages), and the build succeeded in 71 seconds. We cloned commit 03b8a09 into a clean Debian container with 3 CPUs and no project-specific setup.

Do ai-toolbox's tests pass?

The test command failed in our container, and its output did not report a pass or fail count.

Who should not use ai-toolbox?

English-only teams that require complete operator documentation: the app has an English UI, while the main README and detailed gateway docs are Chinese and no separate English README is present.

What are the alternatives to ai-toolbox?

CC Switch, Skills Hub, AxonHub. Our AI Toolbox run installed 785 packages and used 818 MB, then passed its 71-second build and 21-second test step.

Setup3/5Release packages help; source needs Node, pnpm, Rust, and Tauri
Docs3/5Detailed Chinese docs, with English UI but no English README
Community4/51,379 stars and current issue responses around v1.1.4
Maturity3/5Build and tests pass; mappings and database rollback need care

Who it’s for

Developers who regularly switch providers or models across Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw, or Pi.
Windows users who need to copy coding-agent settings, MCP entries, and skills into WSL.
People who manage the same agent setup on remote SSH hosts and accept one desktop app as the source of truth.
Advanced users who want a local gateway with protocol conversion, failover, request logs, and usage accounting.
Chinese-reading operators who can use the repository's detailed native-language documentation.

Who it’s NOT for

English-only teams that require complete operator documentation: the app has an English UI, while the main README and detailed gateway docs are Chinese and no separate English README is present.
Server operators looking for a headless web console or container image: AI Toolbox is a Tauri desktop app, and our checkout had no Dockerfile.
Security teams unwilling to let one application edit provider settings, prompts, sessions, MCP entries, and skills or sync them through WSL, SSH, WebDAV, and S3.
Gateway users who need configurable per-model routing today: open issue 321 asks for that feature instead of documenting it as current behavior.
Codex users who depend on repeated model mappings and every reasoning-effort choice: open issue 305 reports both behaviors missing after mapping.
Anyone planning casual downgrades from v1.1.4: its release notes warn that the database upgrade can stop an older version from starting unless the pre-upgrade database is restored.

Setup reality

Our sandbox installed 785 pnpm packages in 37 seconds and used 818 MB. The build succeeded in 71 seconds, and the available tests succeeded in 21 seconds. The 22.7 MB checkout held 1,198 files and about 359,607 source lines.

Source work needs Node 18 or newer, pnpm 9 or newer, Rust 1.86 or newer, and Tauri's platform prerequisites. Release users get Windows, macOS, and Linux packages. Provider, WebDAV, S3, and SSH features need the matching accounts, endpoints, and credentials; core data lives in local SQLite JSONB tables.

Version 1.1.4 changes the database schema. Its release notes tell users to back up before downgrading and describe restoring the automatic pre-upgrade database. The project has one CI workflow and no Dockerfile, so a passing web build is not proof of every desktop package or remote-sync path.

Version 1.1.4 manages several coding agents from one desktop app

AI Toolbox v1.1.4 is a Tauri application for Windows, macOS, and Linux. It edits provider, model, prompt, plugin, and session settings for OpenCode, Claude Code, Codex, Gemini CLI, OpenClaw, and Pi, with newer Kimi Code support in the latest release. The same interface manages MCP servers and agent skills, then exposes quick switches from the system tray. For someone juggling several assistants, that is a concrete reduction in duplicated configuration work.

The breadth comes with physical size. Our checkout contained 1,198 files and about 359,607 source lines in 22.7 MB before dependencies. The React frontend covers separate modules for each assistant, the local gateway, images, sessions, SSH, WSL, and settings. Rust code behind the Tauri shell handles file access and native integrations. This is a control plane for a developer workstation, not a small tray switcher that only swaps one API key.

What happened when we ran it

Our sandbox installed AI Toolbox in 37 seconds, pulling 785 pnpm packages and using 818 MB on disk. The build succeeded in 71 seconds. The available test command also succeeded in 21 seconds. We ran commit 03b8a09 in a fresh unprivileged Debian container with 3 CPUs, 8 GB of RAM, Node 22 as the base image, and no secrets. The measurement supplied no individual test count, so a pass total cannot be stated.

The repository scan found 1 CI workflow file, no Dockerfile, and no top-level tests directory. Those signals do not contradict the successful 21-second test command, because tests can live elsewhere or run through a script. Our harness checked repository install, build, and the available test target. It did not launch a packaged Tauri application, connect a provider, modify real agent configuration, use WSL or SSH, or restore a backup. The 71-second build is evidence about the command we ran, not every release artifact.

Local SQLite storage still gives the app wide write access

AI Toolbox calls itself local first and stores its main data in SQLite with JSONB records. The documented tables include provider settings, prompts, official-account records, sessions, MCP preferences, skills, gateway settings, image jobs, and remote-sync mappings. The app can also browse, rename, import, export, or delete sessions for supported assistants. A personal database is convenient, yet the application can change files and state that directly affect how several coding agents authenticate and behave.

Backup choices include a local ZIP, WebDAV, and S3-compatible storage, with automatic jobs, selectable items, and sensitive-file filters. WSL synchronization copies CLI, MCP, and skill configuration into Linux paths; SSH synchronization sends selected state to remote hosts. Those features require matching credentials and careful path mapping. The 818 MB dependency install does not assess secret handling or backup correctness. Before adoption, use a test profile, inspect the exported archive, and verify restore behavior without risking the only working agent configuration.

The gateway converts protocols, while per-model routing remains requested

The local proxy gateway can take over Claude Code, Codex, and Gemini CLI traffic, convert between provider protocols, fail over, log requests, track usage, and apply model prices. Its provider-compatibility document is detailed about OpenAI Responses, Chat, Anthropic Messages, Gemini formats, streaming termination, tool calls, images, and retry rules. That specificity helps an operator understand when conversion may lose information. It also shows how much application behavior sits between a coding agent and its upstream provider.

Two open issues mark current boundaries. Issue 321 asks for requests for one model to be routed to a user-selected replacement, so that policy should not be assumed available. Issue 305 reports that a Codex model cannot be mapped back to itself after mapping and that the generated catalog lacks all 6 reasoning-effort choices. Our 21-second test step passed, but it did not use a real provider channel. Test the exact agent, model, streaming mode, and tool-calling path before enabling gateway takeover.

The v1.1.4 database upgrade makes backup part of installation

Release v1.1.4 added Kimi Code CLI support, expanded skill labels and grouping, improved MCP controls, and fixed several Claude Desktop, Claude Code, OMO, and Codex configuration problems. The same release includes a database-schema warning. It says an older version may fail to start after the upgrade because its database version no longer matches. The documented rollback restores the automatically created pre-upgrade .db file, and any changes made after upgrading can be lost with that replacement.

Release users can download MSI or EXE files for Windows, DMG for macOS, and DEB or AppImage for Linux. macOS also has a repository-hosted Homebrew cask, with a quarantine-removal command in the README. Source developers need Node 18+, pnpm 9+, Rust 1.86+, and Tauri prerequisites. Our 37-second pnpm install and 71-second build do not include testing each installer, automatic update, migration, or platform integration. Keep a known-good database copy outside the app's migration path before upgrading.

September activity is strong, and most support happens in Chinese

GitHub showed 1,379 stars, 17 combined issues and pull requests, a last push on September 5, 2026, and v1.1.4 released on September 2. Current tickets received updates through September 5, including quick closures and merged fixes around skills, Claude Code discovery, Kimi, and gateway configuration. That pairing of recent code and issue work indicates active maintenance. The combined open count includes pull requests and should not be read as 17 confirmed bugs.

Language is the practical community limit. The primary README, release notes, detailed gateway documents, and most current issues are Chinese. The app itself lists Chinese and English interfaces, and commands or file paths remain readable, but there is no separate English README in the repository tree we checked. Our successful 785-package install and test step reduce source uncertainty; they do not translate operational guidance. Choose AI Toolbox when its broad desktop authority saves one informed user time. Choose CC Switch, Skills Hub, or AxonHub when one narrower job matters more.

Alternatives

ProjectWhat it isPick it when
CC Switch gh↗A desktop manager for providers and settings across several coding assistants, with separate English and translated READMEs.pick this instead when multilingual documentation and provider switching are the main requirements.
Skills Hub gh↗A focused desktop library for installing and syncing agent skills across coding tools.pick this instead when skills distribution is the whole job and provider, session, and gateway management would add risk.
AxonHubA deployable AI gateway with model routing, failover, cost controls, and tracing.pick this instead when the gateway is shared infrastructure rather than a personal desktop companion.

What people are saying

  1. [github-trending] coulsontl/ai-toolbox

Sources

  1. coulsontl/ai-toolbox repository
  2. AI Toolbox README
  3. AI Toolbox v1.1.4 release
  4. Gateway provider compatibility document
  5. Gateway model-routing request 321
  6. Codex model-mapping issue 305
  7. Codex global-prompt issue 326

More dev tools reviews

lazycodex · cli · comprehensive-rust · aseprite · awesome-cpp · filament · the whole board →