@xagent-ai/cli 1.0.1

package/.eslintrc.js

@@ -0,0 +1,25 @@
+module.exports = {
+  parser: '@typescript-eslint/parser',
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/recommended'
+  ],
+  plugins: ['@typescript-eslint'],
+  env: {
+    node: true,
+    es2022: true
+  },
+  parserOptions: {
+    ecmaVersion: 2022,
+    sourceType: 'module'
+  },
+  rules: {
+    '@typescript-eslint/no-explicit-any': 'warn',
+    '@typescript-eslint/explicit-module-boundary-types': 'off',
+    '@typescript-eslint/no-unused-vars': ['error', { 
+      argsIgnorePattern: '^_',
+      varsIgnorePattern: '^_'
+    }],
+    'no-console': 'off'
+  }
+};

package/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "skills"]
+	path = skills
+	url = https://github.com/anthropics/skills.git

package/.prettierrc.json

@@ -0,0 +1,8 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "trailingComma": "es5",
+  "printWidth": 100,
+  "arrowParens": "always"
+}

package/CONTRIBUTING.md

@@ -0,0 +1,167 @@
+# Contributing to xAgent CLI
+
+Thank you for your interest in contributing to xAgent CLI! This document provides guidelines and instructions for contributing.
+
+## Ways to Contribute
+
+- 🐛 Report bugs
+- 💡 Suggest features
+- 📝 Improve documentation
+- 🔧 Submit pull requests
+- 🧪 Test the application
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js 20+
+- npm 9+
+- TypeScript 5.3+
+
+### Development Setup
+
+1. **Fork the repository**
+
+   Visit [xAgent CLI GitHub](https://github.com/xagent-ai/xagent-cli) and click "Fork".
+
+2. **Clone your fork**
+
+   ```bash
+   git clone https://github.com/YOUR-USERNAME/xagent-cli.git
+   cd xagent-cli
+   ```
+
+3. **Install dependencies**
+
+   ```bash
+   npm install
+   ```
+
+4. **Start development server**
+
+   ```bash
+   npm run dev
+   ```
+
+5. **Run tests**
+
+   ```bash
+   npm test
+   ```
+
+## Code Standards
+
+### TypeScript Guidelines
+
+- Enable strict mode
+- Use ES Module syntax
+- Export all public interfaces
+- Use type annotations
+
+### Naming Conventions
+
+| Type | Convention | Example |
+|------|------------|---------|
+| Class | PascalCase | `AgentManager` |
+| Interface | PascalCase | `AgentConfig` |
+| Enum | PascalCase + UPPER_SNAKE_CASE | `ExecutionMode.YOLO` |
+| File | kebab-case | `cli.ts` |
+
+### Code Style
+
+```bash
+# Format code
+npm run format
+
+# Run linter
+npm run lint
+
+# Type check
+npm run typecheck
+```
+
+## Submitting Changes
+
+### 1. Create a Feature Branch
+
+```bash
+git checkout -b feature/your-feature-name
+```
+
+### 2. Make Changes
+
+- Follow code standards
+- Add unit tests
+- Update documentation
+
+### 3. Commit Changes
+
+```bash
+git add .
+git commit -m "feat: add new feature description"
+```
+
+**Commit Message Format:**
+
+- `feat`: New feature
+- `fix`: Bug fix
+- `docs`: Documentation
+- `refactor`: Code refactoring
+- `test`: Tests
+- `chore`: Maintenance
+
+### 4. Push and PR
+
+```bash
+git push origin feature/your-feature-name
+```
+
+Then open a Pull Request on GitHub.
+
+## Pull Request Guidelines
+
+1. **Clear Title**: Descriptive and concise
+2. **Detailed Description**: Explain what and why
+3. **Screenshots**: For UI changes
+4. **Tests**: Include passing tests
+5. **Checklist**:
+   - [ ] Code follows style guidelines
+   - [ ] Tests pass
+   - [ ] Documentation updated
+   - [ ] No linting errors
+
+## Reporting Bugs
+
+Use GitHub Issues with:
+
+- Clear title
+- Steps to reproduce
+- Expected behavior
+- Actual behavior
+- Environment details
+
+## Feature Requests
+
+Use GitHub Issues with:
+
+- Clear description
+- Use case
+- Potential solution
+- Alternatives considered
+
+## Code of Conduct
+
+- Be respectful and inclusive
+- Welcome newcomers
+- Focus on constructive feedback
+- Keep the community healthy
+
+## Questions?
+
+- Check existing [Documentation](./docs/)
+- Search [GitHub Issues](https://github.com/xagent-ai/xagent-cli/issues)
+- Start a [Discussion](https://github.com/xagent-ai/xagent-cli/discussions)
+
+---
+
+**Thank you for contributing to xAgent CLI!**

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 XAGENT-AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,280 @@
+# 🤖 xAgent CLI - Your Autonomous Life AI Assistant
+
+<div align="center">
+
+![License](https://img.shields.io/badge/License-MIT-yellow?style=flat-square&logo=opensourceinitiative)
+![Node.js](https://img.shields.io/node/v/xagent-cli?logo=node.js)
+![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue?style=flat-square&logo=typescript)
+![Version](https://img.shields.io/npm/v/%40xagent-ai%2Fcli?logo=npm)
+![Downloads](https://img.shields.io/npm/dt/%40xagent-ai%2Fcli)
+
+</div>
+
+<div align="center">
+
+![xAgent CLI Screenshot](./assets/xagent-cli.png)
+
+**[English](README.md)** | **[中文](README_CN.md)**
+
+</div>
+
+---
+
+<div align="center">
+
+### 🚀 The Future of AI Assistants is Here
+
+**xAgent CLI** is not just another AI coding assistant — it's an **intelligent agent for personal PCs and autonomous living** that transforms how you interact with your digital life.
+
+</div>
+
+---
+
+## ✨ Why xAgent CLI?
+
+| 🎯 | Universal AI Companion |
+|------|------------------------|
+| 🏠 | **Life Automation** - From file organization to smart scheduling |
+| 💻 | **Professional Development** - Code, debug, and deploy with AI |
+| 🌐 | **Multi-Model Support** - Free access to Kimi K2, Qwen3 Coder, DeepSeek v3 |
+| 🔧 | **GUI Automation** - Precise mouse/keyboard control for any task |
+| 🔒 | **Flexible Security** - 5 execution modes from YOLO to DEFAULT |
+
+---
+
+## ⚡ Quick Start
+
+```bash
+# Install
+npm i -g xagent-cli
+
+# Launch
+xagent
+```
+
+**That's it!** Start automating your digital life in seconds.
+
+---
+
+## 📊 Feature Comparison
+
+| Feature | xAgent CLI | Claude Code | Gemini CLI |
+|:--------|:----------:|:-----------:|:----------:|
+| **Life Automation** | ✅ | ❌ | ❌ |
+| **PC Smart Management** | ✅ | ❌ | ❌ |
+| Todo Planning | ✅ | ✅ | ❌ |
+| SubAgent System | ✅ | ✅ | ❌ |
+| Plan Mode | ✅ | ✅ | ❌ |
+| Task Tools | ✅ | ✅ | ❌ |
+| Conversation Recovery | ✅ | ✅ | ❌ |
+| Context Auto-compression | ✅ | ✅ | ✅ |
+| Web Search | ✅ | ❌ | ⚠️ |
+| Thinking Mode | ✅ | ✅ | ❌ |
+| Workflow System | ✅ | ❌ | ❌ |
+
+---
+
+## 🎯 What Can xAgent Do?
+
+### 🏠 Life Assistant
+```text
+> Organize my desktop, categorize files by type
+> Set up daily backup to cloud storage
+> Remind me of meetings at 3 PM
+> Find largest files eating disk space
+```
+
+### 💼 Productivity Booster
+```text
+> Batch rename files with date format
+> Download all PDFs from a webpage
+> Analyze Excel data, generate charts
+> Translate documents preserving format
+```
+
+### 👨‍💻 Developer Companion
+```text
+> Analyze project architecture
+> Find and fix bug root causes
+> Create RESTful APIs with auth
+> Code review PRs automatically
+```
+
+### 🔄 Automation Expert
+```text
+> Download stock prices, send email alerts
+> Auto-update project dependencies
+> Monitor websites, alert on downtime
+```
+
+---
+
+## 🛠️ Execution Modes
+
+| Mode | Permissions | Best For |
+|------|-------------|----------|
+| 🟢 **YOLO** | Full control | Complete AI autonomy |
+| 🟡 **ACCEPT_EDITS** | File only | Safe coding |
+| 🔵 **PLAN** | Plan → Execute | Complex tasks |
+| ⚪ **DEFAULT** | Approval required | Security-first |
+| 🟣 **SMART** | Intelligent | Daily use (recommended) |
+
+---
+
+## 🔑 Free to Use
+
+xAgent offers **completely free** access with multiple authentication options:
+
+| Method | Description |
+|--------|-------------|
+| 🔐 **xAgent Account** | Browser-based login (recommended) |
+| 🔑 **API Key** | Server environments |
+| 🌐 **Third-Party APIs** | GLM-4, DeepSeek, Qwen, Kimi, and more |
+
+---
+
+## 🏗️ Technology Stack
+
+<div align="center">
+
+![Node.js](https://img.shields.io/badge/Node.js-22+-green?style=for-the-badge&logo=node.js)
+![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue?style=for-the-badge&logo=typescript)
+![React](https://img.shields.io/badge/React-Ink-purple?style=for-the-badge&logo=react)
+![esbuild](https://img.shields.io/badge/esbuild-orange?style=for-the-badge)
+![Vitest](https://img.shields.io/badge/Vitest-testing?style=for-the-badge&logo=vitest)
+
+</div>
+
+---
+
+## 📦 Project Structure
+
+```
+xagent-cli/
+├── src/
+│   ├── tools/              # 12+ built-in tools
+│   ├── agents/             # SubAgent system
+│   ├── gui-subagent/       # GUI automation
+│   ├── workflow/           # Workflow engine
+│   ├── checkpoint/         # State persistence
+│   └── mcp/                # MCP integration
+├── dist/                   # Compiled output
+├── docs/                   # Documentation
+├── test/                   # Test suite
+└── package.json
+```
+
+---
+
+## 🧪 Testing & Quality
+
+```bash
+npm test          # Unit tests
+npm run lint      # ESLint
+npm run format    # Prettier
+npm run typecheck # TypeScript
+```
+
+---
+
+## ⚙️ Configuration
+
+Customize xAgent by editing `~/.xagent/settings.json`:
+
+```json
+{
+  "theme": "Default",
+  "selectedAuthType": "openai_compatible",
+  "apiKey": "your-api-key",
+  "baseUrl": "https://open.bigmodel.cn/api/coding/paas/v4",
+  "modelName": "glm-4.7",
+  "guiSubagentModel": "doubao-1-5-ui-tars-250428",
+  "guiSubagentBaseUrl": "https://ark.cn-beijing.volces.com/api/v3",
+  "guiSubagentApiKey": "your-api-key",
+  "searchApiKey": "",
+  "executionMode": "smart",
+  "approvalMode": "smart",
+  "checkpointing": {
+    "enabled": false,
+    "autoCreate": true,
+    "maxCheckpoints": 10
+  },
+  "thinking": {
+    "enabled": true,
+    "mode": "normal",
+    "displayMode": "compact"
+  },
+  "contextCompression": {
+    "enabled": true,
+    "maxMessages": 30,
+    "maxContextSize": 1500000,
+    "preserveRecentMessages": 0,
+    "enableSummary": true
+  },
+  "contextFileName": "XAGENT.md",
+  "mcpServers": {},
+  "language": "en",
+  "autoUpdate": true,
+  "telemetryEnabled": true,
+  "showToolDetails": false,
+  "showAIDebugInfo": false,
+  "loggerLevel": "info",
+  "contextCompress": {
+    "enabled": false,
+    "autoTrigger": false,
+    "messageThreshold": 50,
+    "tokenThreshold": 100000,
+    "strategy": "summary",
+    "preserveRecent": 5
+  },
+  "type": "openai_compatible"
+}
+```
+
+---
+
+## 📚 Documentation
+
+- 📖 [Architecture](docs/architecture/overview.md)
+- 🔧 [Tool System](docs/architecture/tool-system-design.md)
+- 🔌 [SKILL, Worflow and MCP Integration](docs/architecture/mcp-integration-guide.md)
+- 💻 [CLI Commands](docs/cli/commands.md)
+- 🤝 [Contributing](CONTRIBUTING.md)
+- 🔑 [Third-Party Models](docs/third-party-models.md)
+
+---
+
+## 🤝 Contributing
+
+We welcome contributions! Here's how to get started:
+
+1. 🍴 Fork the repository
+2. 🌿 Create a feature branch
+3. ✅ Ensure tests pass
+4. 📝 Submit a PR
+
+---
+
+## 📄 License
+
+MIT License - See [LICENSE](./LICENSE)
+
+---
+
+## 🙏 Acknowledgments
+
+<div align="center">
+
+Built with ❤️ using [Ink](https://github.com/vadimdemedes/ink) • Powered by [xAgent Platform](https://platform.xagent.cn/)
+
+</div>
+
+---
+
+<div align="center">
+
+### 🌟 Star us on GitHub!
+
+**Empowering Your Digital Life with AI**
+
+</div>