illusion-code 0.2.0__tar.gz → 0.2.1__tar.gz

illusion_code-0.2.1/PKG-INFO

@@ -0,0 +1,174 @@
+Metadata-Version: 2.4
+Name: illusion-code
+Version: 0.2.1
+Summary: Open-source Python port of Claude Code - an AI-powered CLI coding assistant
+Project-URL: Homepage, https://github.com/YunTaiHua/illusion-code
+Project-URL: Repository, https://github.com/YunTaiHua/illusion-code
+Project-URL: Issues, https://github.com/YunTaiHua/illusion-code/issues
+Author-email: YunTaiHua <3597489498@qq.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,claude-code,cli,coding-agent,llm,terminal
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: anthropic>=0.40.0
+Requires-Dist: croniter>=2.0.0
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: openai>=1.0.0
+Requires-Dist: prompt-toolkit>=3.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pyperclip>=1.9.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: textual>=0.80.0
+Requires-Dist: typer>=0.12.0
+Requires-Dist: uvicorn[standard]>=0.34.0
+Requires-Dist: watchfiles>=0.20.0
+Requires-Dist: websockets>=12.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10.0; extra == 'dev'
+Requires-Dist: pexpect>=4.9.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.5.0; extra == 'dev'
+Provides-Extra: feishu
+Requires-Dist: lark-oapi>=1.4.0; extra == 'feishu'
+Provides-Extra: weixin
+Requires-Dist: aiohttp>=3.9.0; extra == 'weixin'
+Requires-Dist: cryptography>=42.0.0; extra == 'weixin'
+Requires-Dist: qrcode>=7.4.0; extra == 'weixin'
+Description-Content-Type: text/markdown
+
+# IllusionCode
+
+<div align="center">
+
+**AI-Powered Command-Line Programming Assistant**
+
+*The best of many worlds, unified into one intelligent coding tool*
+
+[中文版](README.zh-CN.md) | English
+
+</div>
+
+---
+
+## 📖 Introduction
+
+IllusionCode is an open-source AI-powered command-line programming assistant that brings together the best ideas from many projects and adds its own innovations. It inherits Claude Code's complete prompt system and tool architecture, draws inspiration from OpenHarness's Python architecture design, uses the same Cron task scheduling architecture as OpenClaw, and implements flexible proxy routing through cc-switch. On this foundation, IllusionCode provides deep Windows optimization, full bilingual (Chinese/English) interface support, more comprehensive Markdown terminal rendering than comparable projects, and a browser-based Web UI for a modern chat experience.
+
+### Core Features
+
+- 🌐 **Web UI Interface** - Browser-based chat interface with `illusion web`
+- 🪟 **Deep Windows Optimization** - Auto-detect Git, PowerShell support
+- 🖥️ **Zero Terminal Flicker** - Stable rendering based on Ink Static component
+- 🌍 **Bilingual Interface** - Chinese/English auto-switch via `ui_language` setting
+- 📝 **Comprehensive Markdown Rendering** - Tables, code blocks, rich text
+- 🤖 **Multi AI Provider Support** - Anthropic, OpenAI, Copilot, Codex, and any compatible endpoint
+- 🛠️ **Rich Toolset** - 34 built-in tools + MCP dynamic tool extension
+- ⌨️ **47 Slash Commands** - Session, config, project, scheduling
+- 🧠 **Multi-Agent Collaboration** - 7 built-in specialized Agents
+- 🔌 **Flexible Extension System** - Plugins, hooks, skills, MCP servers
+- 🔐 **Comprehensive Permission Control** - Three modes + fine-grained rules
+- 🎯 **Reasoning Effort Control** - low/medium/high/xhigh/max levels
+
+### Interface Preview
+
+<div align="center">
+  <p>Welcome screen & rich text rendering</p>
+  <img src="docs/images/image1.png" alt="IllusionCode welcome screen" width="48%" />
+  <img src="docs/images/image2.png" alt="IllusionCode rich text rendering" width="48%" />
+</div>
+
+<div align="center">
+  <p>Demo video</p>
+  <a href="https://www.youtube.com/watch?v=ExrzKVjWPls">
+    <img src="docs/images/IllusionCode.png" alt="Click to watch demo video" width="720" />
+  </a>
+  <p><a href="https://www.youtube.com/watch?v=ExrzKVjWPls">📺 Watch demo on YouTube</a></p>
+</div>
+
+---
+
+## 🚀 Quick Start
+
+### Requirements
+
+- Python >= 3.10
+- Node.js 18+
+- Supports Windows, macOS, Linux
+
+### Installation
+
+```bash
+# Recommended: pip install from PyPI
+pip install illusion-code
+
+# Alternative: from source
+git clone https://github.com/YunTaiHua/illusion-code.git
+cd illusion-code
+pip install .
+```
+
+### Basic Usage
+
+```bash
+# First-time: configure authentication
+illusion auth login
+
+# Start interactive session (recommended)
+illusion
+
+# Launch Web UI in browser
+illusion web
+
+# Non-interactive print mode
+illusion -p "Analyze the structure of this project"
+
+# Specify model
+illusion -m env_1.model_2
+```
+
+---
+
+## 📚 Detailed Documentation
+
+| Topic | English | 中文 |
+|-------|---------|------|
+| Introduction | [docs/en/introduction.md](docs/en/introduction.md) | [docs/zh-CN/introduction.md](docs/zh-CN/introduction.md) |
+| Getting Started | [docs/en/getting-started.md](docs/en/getting-started.md) | [docs/zh-CN/getting-started.md](docs/zh-CN/getting-started.md) |
+| Commands | [docs/en/commands.md](docs/en/commands.md) | [docs/zh-CN/commands.md](docs/zh-CN/commands.md) |
+| Settings & Credentials | [docs/en/settings.md](docs/en/settings.md) | [docs/zh-CN/settings.md](docs/zh-CN/settings.md) |
+| Project Files & Memory | [docs/en/project-files.md](docs/en/project-files.md) | [docs/zh-CN/project-files.md](docs/zh-CN/project-files.md) |
+| Extensions (MCP, Plugins, Skills, Hooks) | [docs/en/extensions.md](docs/en/extensions.md) | [docs/zh-CN/extensions.md](docs/zh-CN/extensions.md) |
+| Architecture | [docs/en/architecture.md](docs/en/architecture.md) | [docs/zh-CN/architecture.md](docs/zh-CN/architecture.md) |
+| Messaging Channels | [docs/en/channels.md](docs/en/channels.md) | [docs/zh-CN/channels.md](docs/zh-CN/channels.md) |
+
+---
+
+## 📄 License
+
+This project is open-sourced under the [MIT](LICENSE) license.
+
+---
+
+## 🤝 Contributing
+
+Welcome to submit Issues and Pull Requests!
+
+---
+
+</div>

illusion_code-0.2.1/README.md

@@ -0,0 +1,120 @@
+# IllusionCode
+
+<div align="center">
+
+**AI-Powered Command-Line Programming Assistant**
+
+*The best of many worlds, unified into one intelligent coding tool*
+
+[中文版](README.zh-CN.md) | English
+
+</div>
+
+---
+
+## 📖 Introduction
+
+IllusionCode is an open-source AI-powered command-line programming assistant that brings together the best ideas from many projects and adds its own innovations. It inherits Claude Code's complete prompt system and tool architecture, draws inspiration from OpenHarness's Python architecture design, uses the same Cron task scheduling architecture as OpenClaw, and implements flexible proxy routing through cc-switch. On this foundation, IllusionCode provides deep Windows optimization, full bilingual (Chinese/English) interface support, more comprehensive Markdown terminal rendering than comparable projects, and a browser-based Web UI for a modern chat experience.
+
+### Core Features
+
+- 🌐 **Web UI Interface** - Browser-based chat interface with `illusion web`
+- 🪟 **Deep Windows Optimization** - Auto-detect Git, PowerShell support
+- 🖥️ **Zero Terminal Flicker** - Stable rendering based on Ink Static component
+- 🌍 **Bilingual Interface** - Chinese/English auto-switch via `ui_language` setting
+- 📝 **Comprehensive Markdown Rendering** - Tables, code blocks, rich text
+- 🤖 **Multi AI Provider Support** - Anthropic, OpenAI, Copilot, Codex, and any compatible endpoint
+- 🛠️ **Rich Toolset** - 34 built-in tools + MCP dynamic tool extension
+- ⌨️ **47 Slash Commands** - Session, config, project, scheduling
+- 🧠 **Multi-Agent Collaboration** - 7 built-in specialized Agents
+- 🔌 **Flexible Extension System** - Plugins, hooks, skills, MCP servers
+- 🔐 **Comprehensive Permission Control** - Three modes + fine-grained rules
+- 🎯 **Reasoning Effort Control** - low/medium/high/xhigh/max levels
+
+### Interface Preview
+
+<div align="center">
+  <p>Welcome screen & rich text rendering</p>
+  <img src="docs/images/image1.png" alt="IllusionCode welcome screen" width="48%" />
+  <img src="docs/images/image2.png" alt="IllusionCode rich text rendering" width="48%" />
+</div>
+
+<div align="center">
+  <p>Demo video</p>
+  <a href="https://www.youtube.com/watch?v=ExrzKVjWPls">
+    <img src="docs/images/IllusionCode.png" alt="Click to watch demo video" width="720" />
+  </a>
+  <p><a href="https://www.youtube.com/watch?v=ExrzKVjWPls">📺 Watch demo on YouTube</a></p>
+</div>
+
+---
+
+## 🚀 Quick Start
+
+### Requirements
+
+- Python >= 3.10
+- Node.js 18+
+- Supports Windows, macOS, Linux
+
+### Installation
+
+```bash
+# Recommended: pip install from PyPI
+pip install illusion-code
+
+# Alternative: from source
+git clone https://github.com/YunTaiHua/illusion-code.git
+cd illusion-code
+pip install .
+```
+
+### Basic Usage
+
+```bash
+# First-time: configure authentication
+illusion auth login
+
+# Start interactive session (recommended)
+illusion
+
+# Launch Web UI in browser
+illusion web
+
+# Non-interactive print mode
+illusion -p "Analyze the structure of this project"
+
+# Specify model
+illusion -m env_1.model_2
+```
+
+---
+
+## 📚 Detailed Documentation
+
+| Topic | English | 中文 |
+|-------|---------|------|
+| Introduction | [docs/en/introduction.md](docs/en/introduction.md) | [docs/zh-CN/introduction.md](docs/zh-CN/introduction.md) |
+| Getting Started | [docs/en/getting-started.md](docs/en/getting-started.md) | [docs/zh-CN/getting-started.md](docs/zh-CN/getting-started.md) |
+| Commands | [docs/en/commands.md](docs/en/commands.md) | [docs/zh-CN/commands.md](docs/zh-CN/commands.md) |
+| Settings & Credentials | [docs/en/settings.md](docs/en/settings.md) | [docs/zh-CN/settings.md](docs/zh-CN/settings.md) |
+| Project Files & Memory | [docs/en/project-files.md](docs/en/project-files.md) | [docs/zh-CN/project-files.md](docs/zh-CN/project-files.md) |
+| Extensions (MCP, Plugins, Skills, Hooks) | [docs/en/extensions.md](docs/en/extensions.md) | [docs/zh-CN/extensions.md](docs/zh-CN/extensions.md) |
+| Architecture | [docs/en/architecture.md](docs/en/architecture.md) | [docs/zh-CN/architecture.md](docs/zh-CN/architecture.md) |
+| Messaging Channels | [docs/en/channels.md](docs/en/channels.md) | [docs/zh-CN/channels.md](docs/zh-CN/channels.md) |
+
+---
+
+## 📄 License
+
+This project is open-sourced under the [MIT](LICENSE) license.
+
+---
+
+## 🤝 Contributing
+
+Welcome to submit Issues and Pull Requests!
+
+---
+
+</div>

illusion_code-0.2.1/README.zh-CN.md

@@ -0,0 +1,120 @@
+# IllusionCode
+
+<div align="center">
+
+**AI 驱动的命令行编程助手**
+
+*集百家之所长，融会贯通的智能编程工具*
+
+中文 | [English](README.md)
+
+</div>
+
+---
+
+## 📖 项目简介
+
+IllusionCode 是一个开源的 AI 驱动命令行编程助手，集成了众多优秀项目的精华并加以创新。它继承了 Claude Code 的完整提示词体系和工具架构，在 Python 架构设计上借鉴了 OpenHarness 的理念，采用与 OpenClaw 相同的 Cron 任务调度架构，并通过 cc-switch 反代方案实现了灵活的代理路由。在此基础上，IllusionCode 针对 Windows 系统进行了深度优化，提供了完整的中英双语界面支持，实现了比同类项目更全面的 Markdown 终端渲染能力，并提供了浏览器端的 Web UI 界面。
+
+### 核心特性
+
+- 🌐 **Web UI 界面** - 通过 `illusion web` 启动浏览器聊天界面
+- 🪟 **Windows 系统深度优化** - 自动查找 Git、PowerShell 支持
+- 🖥️ **终端渲染零闪烁** - 基于 Ink Static 组件的稳定渲染
+- 🌍 **中英双语支持** - 所有 CLI 输出根据 `ui_language` 设置自动切换中英文
+- 📝 **全面 Markdown 渲染** - 直角边框表格、圆角卡片代码块、多色富文本
+- 🤖 **多 AI 提供商支持** - Anthropic Claude、OpenAI、GitHub Copilot、OpenAI Codex 及任意 OpenAI 兼容端点
+- 🛠️ **丰富的工具集** - 34 内置工具 + MCP 动态工具扩展
+- ⌨️ **47 个斜杠命令** - 覆盖会话管理、配置、项目操作、任务调度等
+- 🧠 **多智能体协作** - 7 种内置专业 Agent，支持任务编排
+- 🔌 **灵活扩展系统** - 插件、钩子、技能、MCP 服务器
+- 🔐 **完善权限控制** - 三种模式 + 细粒度规则 + Always Allow 一键放行
+- 🎯 **推理强度控制** - 支持 low/medium/high/xhigh/max 五种推理强度级别
+
+### 界面展示
+
+<div align="center">
+  <p>欢迎界面 & 富文本渲染</p>
+  <img src="docs/images/image1.png" alt="IllusionCode 欢迎界面" width="48%" />
+  <img src="docs/images/image2.png" alt="IllusionCode 富文本渲染" width="48%" />
+</div>
+
+<div align="center">
+  <p>演示视频</p>
+  <a href="https://b23.tv/3mWe9It">
+    <img src="docs/images/IllusionCode.png" alt="点击观看演示视频" width="720" />
+  </a>
+  <p><a href="https://b23.tv/3mWe9It">📺 B站观看演示视频</a></p>
+</div>
+
+---
+
+## 🚀 快速开始
+
+### 环境要求
+
+- Python >= 3.10
+- Node.js 18+
+- 支持 Windows、macOS、Linux
+
+### 安装
+
+```bash
+# 推荐方式：从 PyPI 安装
+pip install illusion-code
+
+# 备选方式：从源码安装
+git clone https://github.com/YunTaiHua/illusion-code.git
+cd illusion-code
+pip install .
+```
+
+### 基本使用
+
+```bash
+# 首次使用：配置认证
+illusion auth login
+
+# 启动交互式会话（推荐）
+illusion
+
+# 启动 Web UI 浏览器界面
+illusion web
+
+# 非交互式打印模式
+illusion -p "帮我分析这个项目的结构"
+
+# 指定模型
+illusion -m env_1.model_2
+```
+
+---
+
+## 📚 详细文档
+
+| 主题 | English | 中文 |
+|------|---------|------|
+| 项目简介 | [docs/en/introduction.md](docs/en/introduction.md) | [docs/zh-CN/introduction.md](docs/zh-CN/introduction.md) |
+| 快速开始 | [docs/en/getting-started.md](docs/en/getting-started.md) | [docs/zh-CN/getting-started.md](docs/zh-CN/getting-started.md) |
+| 命令系统 | [docs/en/commands.md](docs/en/commands.md) | [docs/zh-CN/commands.md](docs/zh-CN/commands.md) |
+| 设置与凭据 | [docs/en/settings.md](docs/en/settings.md) | [docs/zh-CN/settings.md](docs/zh-CN/settings.md) |
+| 项目文件与记忆 | [docs/en/project-files.md](docs/en/project-files.md) | [docs/zh-CN/project-files.md](docs/zh-CN/project-files.md) |
+| 扩展系统 (MCP, 插件, 技能, 钩子) | [docs/en/extensions.md](docs/en/extensions.md) | [docs/zh-CN/extensions.md](docs/zh-CN/extensions.md) |
+| 项目架构 | [docs/en/architecture.md](docs/en/architecture.md) | [docs/zh-CN/architecture.md](docs/zh-CN/architecture.md) |
+| 消息渠道 | [docs/en/channels.md](docs/en/channels.md) | [docs/zh-CN/channels.md](docs/zh-CN/channels.md) |
+
+---
+
+## 📄 许可证
+
+本项目采用 [MIT](LICENSE) 许可证开源。
+
+---
+
+## 🤝 贡献
+
+欢迎提交 Issue 和 Pull Request！
+
+---
+
+</div>

illusion_code-0.2.1/docs/en/architecture.md

@@ -0,0 +1,126 @@
+# Project Architecture
+
+```
+illusion-code/
+├── src/illusion/           # Main source code
+│   ├── api/                # API clients (Anthropic, OpenAI, etc.)
+│   ├── auth/               # Authentication management
+│   ├── commands/           # Slash command system (47 commands)
+│   ├── config/             # Configuration system
+│   ├── coordinator/        # Multi-agent coordinator
+│   ├── engine/             # Core conversation engine
+│   ├── hooks/              # Hook system
+│   ├── mcp/                # MCP client
+│   ├── memory/             # Memory system
+│   ├── permissions/        # Permission system
+│   ├── plugins/            # Plugin system
+│   ├── prompts/            # Prompt system
+│   ├── skills/             # Skill system
+│   ├── tasks/              # Task management
+│   ├── tools/              # Toolset (34 base tools)
+│   ├── ui/                 # User interface
+│   │   ├── web/            # Web backend (FastAPI + WebSocket)
+│   │   └── ...
+│   └── cli.py              # CLI entry point
+├── frontend/
+│   ├── terminal/           # React Ink TUI frontend
+│   └── web/                # React Web frontend (Vite + Tailwind)
+├── tests/                  # Test suite
+└── pyproject.toml          # Project configuration
+```
+
+---
+
+## Core Modules
+
+### API Client Layer
+
+Supports multiple AI providers:
+
+| Provider | API Format | Authentication |
+|----------|------------|----------------|
+| Anthropic Claude | anthropic | API Key |
+| OpenAI / Compatible | openai | API Key |
+| GitHub Copilot | openai | OAuth Device Flow |
+| OpenAI Codex | openai | External CLI (Codex CLI) |
+| Custom Provider | anthropic / openai | API Key |
+
+### Tool System
+
+Provides 34 core tools, covering:
+
+- **File Operations**: `file_read`, `file_write`, `file_edit`, `notebook_edit`
+- **Command Execution**: `bash`, `powershell`, `repl`
+- **Search**: `glob`, `grep`, `web_fetch`, `web_search`, `tool_search`
+- **Task Management**: `task_create`, `task_get`, `task_list`, `task_update`, `task_output`, `task_stop`
+- **Agent Collaboration**: `agent`, `send_message`, `team_create`, `team_delete`
+- **Mode Switching**: `enter_plan_mode`, `exit_plan_mode`
+- **Session Control**: `enter_worktree`, `exit_worktree`, `todo_write`, `sleep`
+- **Config & Debug**: `config`, `lsp`, `mcp_auth`, `skill`, `structured_output`
+- **Interaction**: `ask_user_question`
+- **Scheduled Tasks**: `cron` (unified tool with status/list/add/update/remove/run actions)
+
+### Permission System
+
+Three permission modes:
+
+| Mode | Description |
+|------|-------------|
+| `default` | Modification tools require user confirmation |
+| `plan` | Block all modification tools |
+| `full_auto` | Allow all operations |
+
+### Multi-Agent Coordinator
+
+Built-in 7 specialized Agents:
+
+| Agent | Purpose |
+|-------|---------|
+| `general-purpose` | General research and multi-step tasks |
+| `Explore` | File search and code exploration expert |
+| `Plan` | Architecture design and implementation planning expert |
+| `verification` | Adversarial verification expert |
+| `worker` | Implementation-oriented Worker |
+| `statusline-setup` | Shell PS1 converter |
+| `illusion-guide` | Illusion Code / SDK / API documentation expert |
+
+---
+
+## Frontend Tech Stack
+
+### Terminal TUI (Ink)
+
+| Technology | Version | Purpose |
+|------------|---------|---------|
+| React | 18.3.1 | UI framework |
+| Ink | 5.1.0 | Terminal UI component library |
+| TypeScript | 5.7.3 | Type safety |
+
+### Web UI
+
+| Technology | Version | Purpose |
+|------------|---------|---------|
+| React | 18.x | UI framework |
+| Vite | 6.x | Build tool and dev server |
+| Tailwind CSS | 3.x | Utility-first CSS framework |
+| TypeScript | 5.x | Type safety |
+| FastAPI | - | Backend API framework |
+| WebSocket | - | Real-time bidirectional communication |
+
+---
+
+## Main Dependencies
+
+| Dependency | Purpose |
+|------------|---------|
+| anthropic | Anthropic SDK |
+| openai | OpenAI SDK |
+| rich | Rich text output |
+| prompt-toolkit | Advanced input processing |
+| textual | TUI framework |
+| typer | CLI framework |
+| pydantic | Data validation |
+| httpx | HTTP client |
+| mcp | MCP protocol |
+| fastapi | Web backend API framework |
+| uvicorn | ASGI server for Web backend |