An autonomous life AI CLI assistant for personal PCs, featuring multi-agent collaboration, GUI desktop automation, and workflow orchestration.
xAgent CLI is a cross-platform command-line AI assistant positioned as an autonomous life automation hub for personal PCs. Built on Node.js ≥ 20 with Ink (React for CLI) + React 19 for terminal UI, implemented in TypeScript.
Core capabilities span three layers: File & Terminal layer provides 12+ built-in tools (file operations, web search, code analysis, Git integration, etc.); GUI Desktop layer enables precise mouse/keyboard control and screenshot recognition via @computer-use/nut-js, with GUI SubAgent supporting independent vision model configuration; Collaboration & Orchestration layer supports Multi-Agent Team parallel execution, SubAgent task delegation, and Workflow Engine for custom orchestration.
Offers 5 execution modes (yolo/accept_edits/plan/default/smart), built-in automatic context compression (triggers at 30 messages or 1.5M tokens), checkpoint persistence with conversation recovery, and configurable thinking modes. Extensible via MCP protocol for tool integration and Skills system for installing extensions (compatible with anthropics/skills format). Free access to Kimi K2, Qwen3 Coder, DeepSeek v3, GLM-5 and more, with independent model configuration for main agent and GUI sub-agent.
Typical scenarios: intelligent desktop file organization, batch document translation and format conversion, Excel data analysis, project architecture analysis and bug fixing, multi-role collaborative development, cross-application automation workflows (e.g., data download → analysis → email notification).
Installation:
npm i -g @xagent-ai/cli
xagent start
Key interactive commands: /init (initialize project context), /agents (manage SubAgents), /mcp (manage MCP servers), /skill (manage skills), /model (configure model), /mode (switch execution mode), /restore (recover past sessions).
Configuration: ~/.xagent/settings.json, supporting independent main model and GUI sub-agent model config, execution modes, thinking modes, context compression thresholds, checkpoint persistence, MCP servers, and more.
Caveats: npm package @xagent-ai/cli public registry publication status is unverified; GUI automation OS compatibility boundaries (macOS/Windows/Linux) are not detailed; development team background is not disclosed in the repository.