AgentX (agent-studio)

Positioning & Problem#

Developers face fragmented experiences when switching between multiple AI coding agents like Claude Code, Codex, and Copilot across different CLI windows or IDE plugins. AgentX serves as a desktop client and interaction aggregation layer. It does not include LLM inference capabilities itself; instead, it connects to local or remote Agent backends via ACP, supports OpenAI-compatible API direct connections, and dynamically extends Agent toolchains through MCP.

Core Capabilities#

Agent Connection & Management#

• Concurrent multi-Agent connections via ACP: Claude, Codex, Kimi Code, Qwen, Qoder, OpenCode, Gemini, AugmentCode, Iflow, and more
• OpenAI-compatible API direct model configuration
• Custom Prompt command templates

Interaction & Visualization#

• Real-time streaming response display
• Native thinking blocks and tool call process visualization
• Multi-session organization with JSONL auto-save

Development Environment Integration#

• Built-in code editor with LSP, Tree-sitter syntax highlighting and auto-completion
• Integrated terminal for in-app command execution
• MCP toolchain configuration supporting stdio/HTTP/SSE transports (filesystem, GitHub, etc.)
• Built-in Git worktree management

Desktop Experience#

• GPU-accelerated rendering via GPUI
• Draggable customizable Dock panel layouts (state persisted)
• Light/dark themes with custom colors
• System tray support
• Built-in version check and auto-update
• English and Chinese internationalization

Architecture#

Rust Workspace modular architecture with core domains: agentx-types, agentx-event-bus, agentx-agent, agentx-services, agentx-acp-ui, and git-worktree-manager.

Rendering powered by Zed Industries' GPUI framework, with custom gpui-component (UI library) and gpui-term (terminal component). Async runtime: Tokio. HTTP client: reqwest (Zed fork). Serialization: serde/serde_json.

Release builds use aggressive size optimization (opt-level = "z", lto = "fat", codegen-units = 1); Dev builds use opt-level = 1.

Installation#

Download from GitHub Releases:

• macOS: agentx-macos.dmg → drag to Applications
• Windows: agentx-windows.msi installer or agentx-windows.exe portable
• Linux: sudo dpkg -i agentx-linux.deb or extract agentx-linux.tar.gz portable (requires Vulkan, GTK3 dependencies)

Configuration#

All connections and extensions managed via config.json:

• agent_servers: Agent command, args, environment variables
• models: Third-party API provider, base_url, api_key, model_name
• mcpServers: stdio/HTTP/SSE tool server configurations
• commands: Custom prompt templates

Debug mode: RUST_LOG=info cargo run. Reset layout by deleting docks-agentx.json. Layout files in agentx/, session data in sessions/.

Current version: v0.3.1. Open source under Apache-2.0.