Skip to content

thornboo/LingShu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

LingShu Logo

LingShu (灵枢)

A Minimalist Multi-Agent Collaboration Orchestration Framework

Turn your ideas into reality without worrying about tool configuration or workflow setup.

English | 简体中文

Electron React TypeScript Tailwind CSS pnpm Biome License


Key Features

🤖 Multi-Agent Collaboration

Use Claude Code, Codex CLI, Gemini CLI, and other AI Agents simultaneously. Each Agent works in parallel within its own isolated Worktree.

🌿 Git Worktree Isolation

Each branch has its own physical directory, editor state, terminal session, and Agent context. Say goodbye to git stash — true parallel development.

📝 Professional IDE Experience

Monaco Editor (same as VS Code) + xterm.js terminal + file tree + version control. A professional development environment out of the box.

🔗 Deep Claude Integration

IDE Bridge for real-time editor state sync, MCP service management, Hook injection, Prompt management — deeply integrated with Claude Code.

🎨 AI-Enhanced Features

AI-generated commit messages, AI-generated branch names, streaming code review. Let AI enhance every step of your development workflow.

🌐 Chinese-First

Native Chinese experience, designed for Chinese developers, lowering the barrier to AI-assisted programming collaboration.


Screenshots

Agent Chat Panel - Real-time conversation with AI Agents

Agent Panel

Code Editor - Professional editing with Monaco Editor

Code Editor

Git Version Control - Visual Git operations

Git Version Control

Integrated Terminal - WebGL high-performance terminal

Integrated Terminal

Three-Way Merge - Visual conflict resolution

Three-Way Merge


Architecture Overview

┌──────────────────────────────────────────────────────────────┐
│                       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)                │    │
│  └──────────────────────────────────────────────────────┘    │
└──────────────────────────────────────────────────────────────┘

Comparison with Similar Products

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)

Project Vision

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.

Core Philosophy

  1. 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.
  2. Zero Configuration: Developer time should be spent on coding, not configuring tools. LingShu provides built-in presets for major AI providers and MCP services.
  3. Quality Built-in: From automated code reviews to strict workflow stages, quality control is woven into the fabric of the development process.
  4. Workflow Orchestration: Beyond simple chat, LingShu orchestrates complex development workflows—from requirements analysis to implementation and verification.

Product Matrix

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

Tech Stack

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

Quick Start

Build from Source

# 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 dev

Build Application

pnpm build:mac    # macOS (DMG)
pnpm build:win    # Windows (NSIS)
pnpm build:linux  # Linux (AppImage)

Code Quality

pnpm lint         # Lint code
pnpm lint:fix     # Auto-fix issues
pnpm typecheck    # Type checking

Detailed installation guide: See Getting Started


Roadmap

  • 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


Documentation

User Documentation

Browse the full docs site: https://thornboo.github.io/LingShu/

Feature Guides

Tutorials

Developer Documentation


Contributing

We welcome all forms of contribution! See CONTRIBUTING.md for:

  • Development environment setup
  • Code standards and commit conventions
  • Pull Request process
  • Electron development notes

Acknowledgments

See NOTICE.md for open source acknowledgments and third-party resource credits.


License

MIT License - Copyright (c) 2026 LingShu Contributors

About

A Minimalist Multi-Agent Collaboration Orchestration Framework

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors