# tuui | AIQL | Knowledge Base | Instagit

A desktop MCP client designed as a tool unitary utility integration, accelerating AI adoption through the Model Context Protocol (MCP) and enabling cross-vendor LLM API orchestration.

GitHub Stars: 1.1k

Repository: https://github.com/ai-ql/tuui

---

## Articles

### [TUUI Development Setup and Dependency Management: Complete Guide](/ai-ql/tuui/development-setup-and-dependency-management-for-tuui-based-on-package-json)

Master TUUI development setup and dependency management with this guide. Learn about its Electron-Vite-Vue architecture and package.json configuration for efficient cross-platform packaging.

- Tags: how-to-guide
- Published: 2026-02-23

### [How Keyboard Shortcuts Are Registered and Managed Globally in TUUI](/ai-ql/tuui/how-keyboard-shortcuts-registered-and-managed-globally-in-tuui)

Discover how TUUI registers and manages global keyboard shortcuts using Electron's globalShortcut API in its main process for efficient hotkey handling.

- Tags: internals
- Published: 2026-02-23

### [How TUUI Manages Global State with Pinia Store Architecture](/ai-ql/tuui/how-tuui-manage-global-state-across-application-using-pinia-store-architecture)

Discover how TUUI manages global state with its Pinia store architecture. Learn how reactive, singleton stores orchestrate chat inference, tool execution, and UI state in their Electron-Vue app.

- Tags: architecture
- Published: 2026-02-23

### [TUUI MCP Architecture: How Tools, Prompts, and Resources Are Handled](/ai-ql/tuui/architecture-handling-mcp-tools-prompts-and-resources-within-tuui)

Explore the TUUI MCP architecture for managing tools, prompts, and resources. Discover TUUI's three-layer system for uniform handling across MCP servers.

- Tags: architecture
- Published: 2026-02-23

### [How TUUI Manages Remote MCP Servers with Cloudflare mcp-remote Integration](/ai-ql/tuui/how-tuui-manage-remote-mcp-servers-specifically-with-cloudflare-mcp-remote-integration)

Discover how TUUI manages remote MCP servers using Cloudflare mcp-remote integration. Learn to establish SSE tunnels for seamless remote connectivity with this powerful solution.

- Tags: how-to-guide
- Published: 2026-02-23

### [How TUUI Resolves MCP Server Spawn Errors on Windows and macOS](/ai-ql/tuui/what-tuui-strategy-resolving-mcp-server-spawn-errors-on-windows-and-macos)

Resolve MCP server spawn errors on Windows and macOS with TUUI's platform-specific strategies. Learn about SDK patches, absolute paths, and environment adjustments.

- Tags: how-to-guide
- Published: 2026-02-23

### [How TUUI Integrates the System Tray: Menu Creation and Window Management](/ai-ql/tuui/how-system-tray-integrated-into-tuui-including-menu-creation-and-window-management)

Discover how TUUI integrates the system tray for seamless menu creation and window management. Explore the createTray function and its advanced features for a better user experience.

- Tags: how-to-guide
- Published: 2026-02-23

### [Configuration and Workflow for Building and Packaging TUUI with Vite and electron-builder](/ai-ql/tuui/configuration-and-workflow-for-building-and-packaging-tuui-with-vite-and-electron-builder)

Learn the configuration and workflow for building and packaging TUUI with Vite and electron-builder. This guide covers bundling Vue 3, Electron processes, and creating native installers.

- Tags: how-to-guide
- Published: 2026-02-23

### [Architecture and Purpose of the Preload Script in TUUI for Exposing Safe APIs](/ai-ql/tuui/architecture-and-purpose-preload-script-in-tuui-for-exposing-safe-apis)

Explore the TUUI preload script architecture guarding Electron sandboxed renderers. Discover how it securely exposes safe APIs via contextBridge, enforcing least privilege for robust application security.

- Tags: architecture
- Published: 2026-02-23

### [MCP Registry Discovery in TUUI: How It Works and Integrates with the UI](/ai-ql/tuui/mechanism-mcp-registry-discovery-in-tuui-and-how-is-it-integrated)

Discover how TUUI finds MCP servers using the public MCP Registry API and displays results in a Vue card component. Learn about the seamless integration with the UI and gain valuable insights.

- Tags: internals
- Published: 2026-02-23

### [How TUUI Implements MCP Bundle (.mcpb) Support Using the @anthropic-ai/mcpb SDK](/ai-ql/tuui/how-tuui-implement-support-for-mcp-bundles-using-anthropic-ai-mcpb-sdk)

Discover how TUUI implements MCP Bundle support leveraging the @anthropic-ai/mcpb SDK. Learn to unpack, validate, and convert .mcpb files into server configurations.

- Tags: how-to-guide
- Published: 2026-02-23

### [Understanding the Window Management System in TUUI: Splash, Main, and Error Windows](/ai-ql/tuui/describe-window-management-system-in-tuui-including-splash-main-and-error-window-creation)

Explore TUUI's window management system Learn how splash main and error windows are created and managed for smooth transitions and crash recovery. Discover centralized window factories. ai-ql/tuui

- Tags: internals
- Published: 2026-02-23

### [TUUI's MCP Elicitation Protocol: How User Consent Flows from Server to UI](/ai-ql/tuui/flow-tuui-mcp-elicitation-protocol-for-obtaining-user-consent-during-operations)

Explore TUUI's MCP elicitation protocol. Understand the 9-step server to UI consent flow for secure user approval before MCP servers execute privileged operations. Learn how user consent is managed.

- Tags: how-to-guide
- Published: 2026-02-23

### [How TUUI Initializes MCP Servers with a 90-Second Timeout for Runtime Installations](/ai-ql/tuui/how-tuui-handle-initialization-mcp-servers-including-90-second-timeout-for-runtime-installations)

Learn how TUUI initializes MCP servers via a three-step pipeline. Discover its 90-second idle timeout for preventing runtime installation hangs.

- Tags: how-to-guide
- Published: 2026-02-23

### [How TUUI Integrates Pinia State Persistence with LocalStorage for Configuration Management](/ai-ql/tuui/how-pinia-state-persistence-integrated-with-localstorage-in-tuui-for-configuration-management)

Learn how TUUI integrates Pinia state persistence with localStorage for seamless configuration management. Keep your settings across restarts without manual code. Explore the ai-ql/tuui repo.

- Tags: how-to-guide
- Published: 2026-02-23

### [TUUI Cross-Vendor LLM API Orchestration Architecture: Inside the Electron-Based Multi-Provider System](/ai-ql/tuui/internal-architecture-tuui-cross-vendor-llm-api-orchestration-system)

Explore TUUI's cross-vendor LLM API orchestration architecture. Understand its four-layer system built with Electron Vue and Pinia for seamless multi-provider LLM integration.

- Tags: architecture
- Published: 2026-02-23

### [How TUUI Implements the MCP Sampling Protocol for LLM Tool Calls: IPC Architecture Explained](/ai-ql/tuui/how-does-tuui-implement-mcp-sampling-protocol-for-llm-tool-calls-including-ipc-mechanisms)

Discover how TUUI implements MCP sampling for LLM tool calls using UUID-based IPC channels. Learn about its IPC architecture and UI component integration.

- Tags: deep-dive
- Published: 2026-02-23