A Minimalist Multi-Agent Collaboration Orchestration Framework
Turn your ideas into reality without worrying about tool configuration or workflow setup.
English | 简体中文
|
Use Claude Code, Codex CLI, Gemini CLI, and other AI Agents simultaneously. Each Agent works in parallel within its own isolated Worktree. |
Each branch has its own physical directory, editor state, terminal session, and Agent context. Say goodbye to |
|
Monaco Editor (same as VS Code) + xterm.js terminal + file tree + version control. A professional development environment out of the box. |
IDE Bridge for real-time editor state sync, MCP service management, Hook injection, Prompt management — deeply integrated with Claude Code. |
|
AI-generated commit messages, AI-generated branch names, streaming code review. Let AI enhance every step of your development workflow. |
Native Chinese experience, designed for Chinese developers, lowering the barrier to AI-assisted programming collaboration. |
┌──────────────────────────────────────────────────────────────┐
│ Electron Shell │
│ │
│ ┌───────────────────┐ IPC ┌─────────────────────────┐ │
│ │ Renderer Process │ ◀═════▶ │ Main Process │ │
│ │ │ │ │ │
│ │ React 19 │ │ 18 IPC Modules │ │
│ │ 100+ Components │ │ Git / Terminal / Claude │ │
│ │ 15 Zustand Stores │ │ AI / Files / Search │ │
│ │ 19 Custom Hooks │ │ Agent / Hapi / Updater │ │
│ └───────────────────┘ └─────────────────────────┘ │
│ │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ Shared Types (16 modules) │ │
│ └──────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────────┘
| Aspect | Cursor | Windsurf | VS Code + Copilot | LingShu |
|---|---|---|---|---|
| Positioning | AI Code Editor | AI IDE | Plugin Enhancement | Multi-Agent Collaboration Framework |
| Agent Support | Built-in | Built-in | Plugin | Claude + Codex + Gemini + Custom |
| Multi-Agent Parallel | ❌ | ❌ | ❌ | ✅ Worktree Isolation |
| Git Worktree | ❌ | ❌ | Plugin | ✅ First-Class Citizen |
| Session Persistence | Partial | Partial | ❌ | ✅ Full Persistence |
| Visual Orchestration | ❌ | ❌ | ❌ | ✅ (Planned) |
| Open Source | ❌ | ❌ | Partial | ✅ MIT License |
| Chinese-First | ❌ | ❌ | ❌ | ✅ |
| Zero Configuration | Partial | Partial | ❌ | ✅ (Planned) |
LingShu: The Next-Generation Multi-Agent Orchestration Platform
LingShu aims to bridge the gap between human ideas and software reality. By orchestrating multiple AI Agents in parallel, it transforms the development process from a serial, manual workflow into a parallel, intelligent collaboration.
- Parallelism First: Why wait for one task to finish? LingShu treats Git Worktrees as parallel execution units, allowing multiple Agents to work on different features simultaneously.
- Zero Configuration: Developer time should be spent on coding, not configuring tools. LingShu provides built-in presets for major AI providers and MCP services.
- Quality Built-in: From automated code reviews to strict workflow stages, quality control is woven into the fabric of the development process.
- Workflow Orchestration: Beyond simple chat, LingShu orchestrates complex development workflows—from requirements analysis to implementation and verification.
LingShu Ecosystem
├── LingShu Desktop (Electron Desktop App) ← Current Project
│ ├── IDE Experience: File Tree + Monaco Editor + Terminal
│ ├── Visual Workflow Orchestration
│ ├── Multi-Agent Collaboration
│ └── Best for: GUI users, visual requirements
│
└── LingShu CLI (Node.js CLI Tool) [Planned]
├── Hook System
├── Multi-Agent Pipeline
└── Best for: Server environments, CLI enthusiasts
| Layer | Technology | Version |
|---|---|---|
| Framework | Electron | 39.2.7 |
| Frontend | React + TypeScript | 19.1.4 / 5.9.3 |
| Styling | Tailwind CSS | 4.1.18 |
| State Management | Zustand | 5.0.9 |
| Editor | Monaco Editor | 0.55.1 |
| Terminal | xterm.js + node-pty | 6.1.0 / 1.1.0 |
| Syntax Highlighting | Shiki | 3.20.0 |
| Animation | Framer Motion | 12.23.26 |
| Git | simple-git | 3.30.0 |
| Search | @vscode/ripgrep | 1.17.0 |
| Build | electron-vite | 5.0.0 |
# Prerequisites: Node.js 20+, pnpm 10.26+, Git 2.20+
# Clone the repository
git clone https://github.com/thornboo/LingShu.git
cd LingShu
# Install dependencies
pnpm install
# Development mode
pnpm devpnpm build:mac # macOS (DMG)
pnpm build:win # Windows (NSIS)
pnpm build:linux # Linux (AppImage)pnpm lint # Lint code
pnpm lint:fix # Auto-fix issues
pnpm typecheck # Type checkingDetailed installation guide: See Getting Started
- Phase 0: Core Capabilities — ✅ Complete
- IDE experience, Git Worktree, Multi-Agent support, Deep Claude integration
- Phase 1: Zero Configuration Experience
- API preset system, Proxy service support, Multi-language UI
- Phase 2: Workflow Engine
- Four-stage workflow, Package mechanism, Acceptance system
- Phase 3: Quality Control
- Multi-Agent pipeline, Ralph Loop quality gates, Standard injection
- Phase 4: Visual Orchestration
- Drag-and-drop workflow, Template marketplace, Real-time progress visualization
Detailed progress: See Implementation Status
- Getting Started — Installation and initial setup
- Interface Overview — Main interface areas
- Initial Configuration — API Key and Agent configuration
- FAQ — Frequently asked questions
- Product Vision — Product roadmap
Browse the full docs site: https://thornboo.github.io/LingShu/
- Code Editor — Monaco Editor features
- Integrated Terminal — xterm.js terminal features
- Git Version Control — Git operations guide
- Worktree Management — Git Worktree isolation
- Agent Collaboration — Multi-Agent collaboration
- Hapi Remote Sharing — Remote Agent sharing via Web/Telegram
- Claude Integration — Deep Claude integration
- Codex Integration — Codex CLI guide
- Gemini Integration — Gemini CLI guide
- Code Review — AI code review
- Settings System — Settings pages guide
- Basic Operations — Daily development workflow
- Advanced Tips — Advanced usage tips
- Keyboard Shortcuts — Keyboard shortcuts reference
- System Architecture — Overall technical architecture
- Main Process Architecture — Main Process details
- Renderer Process Architecture — Renderer Process details
- IPC Communication Design — IPC channel design
- Implementation Status — Feature implementation progress
- Design System — UI design specifications
- Component Guidelines — Component usage guidelines
- Z-Index Management — z-index specifications
- IPC Channel List — Complete IPC channel reference
- Type Definitions — Shared types documentation
- State Management — Zustand Store API
- Development Guidelines — Code and documentation standards
- Contributing Guide — How to contribute
- Changelog — Version history
We welcome all forms of contribution! See CONTRIBUTING.md for:
- Development environment setup
- Code standards and commit conventions
- Pull Request process
- Electron development notes
See NOTICE.md for open source acknowledgments and third-party resource credits.
MIT License - Copyright (c) 2026 LingShu Contributors





