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, and more comprehensive Markdown terminal rendering than comparable projects.
ui_language settingInherited from Claude Code: Complete injection of Claude Code's system prompts, tool definitions, permission model, and multi-agent coordination architecture, ensuring behavioral consistency.
Inspired by OpenHarness: Python architecture design references OpenHarness's ideas.
Cron Architecture Aligned with OpenClaw: The scheduled task system uses the same scheduler architecture as OpenClaw, supporting independent session execution, execution history tracking, and consecutive error monitoring.
cc-switch Proxy Routing: Local proxy routing through the cc-switch reverse proxy tool, supporting request forwarding to different AI providers.
Deep Windows Optimization: Auto-detect Git installation path, unified PowerShell and Bash tool processing, automatic path separator compatibility, out-of-the-box experience for Windows users.
Zero Terminal Flicker: Uses Ink <Static> component architecture, static rendering for completed messages, dynamic rendering for streaming messages, completely solving terminal flicker issues.
Bilingual Interface: All CLI output (auth, mcp, plugin, cron, session, etc.) automatically switches language via the i18n system based on the ui_language field. Language preference can be selected on first run.
Comprehensive Markdown Rendering: Full rendering of box-drawing tables, rounded card-style code blocks, multi-color rich text (bold, italic, inline code, links), significantly improving AI response readability.
Project-Level Config Automation: Auto-generate <project>/.illusion/rules/ and <project>/.illusion/skills/ directories, project-level configuration takes precedence over global configuration, facilitating team collaboration.
git clone github.com/your-repo/illusion-code.git
cd illusion-code
uv sync
Note:
uv synconly creates a virtual environment within the project directory and does NOT register theillusioncommand globally in your PATH. To useillusionfrom any directory, use one of:# Option 1: Use uv run from the project directory cd illusion-code uv run illusion # Option 2: Activate the virtual environment first # Windows .venv\Scripts\activate # macOS / Linux source .venv/bin/activate illusion # Option 3: Install globally with pip pip install -e .
First-time setup: Run
uv run illusion auth loginfirst to configure your API credentials. Without authentication (or if the model is unavailable), the program may exit with an error code.
# First-time: configure authentication
uv run illusion auth login
# Start interactive session (recommended)
illusion
# Non-interactive print mode
illusion -p "Analyze the structure of this project"
# Specify model
illusion -m env_1.model_2
# Continue most recent session
illusion --continue
# Restore specific session
illusion --resume <session-id>
# Set permission mode
illusion --permission-mode full_auto
# Specify API format
illusion --api-format openai
No responses yet.