---
slug: "yishan-io-pi-subagents"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/yishan-io/yishan-mono@main/README.md"
repo: "https://github.com/yishan-io/yishan-mono"
source_file: "README.md"
branch: "main"
---
<p align="center">
  <img src="apps/desktop/src/assets/images/yishan-transparent.png" alt="Yishan logo" width="100" height="100" />
</p>

<h1 align="center">Yishan</h1>

<p align="center">
  <a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a>
</p>

<p align="center">
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-Elastic--2.0-blue.svg" alt="License" /></a>
  <a href="https://github.com/yishan-io/yishan-mono/actions/workflows/pr-unit-tests.yml"><img src="https://github.com/yishan-io/yishan-mono/actions/workflows/pr-unit-tests.yml/badge.svg" alt="PR Unit Tests" /></a>
   <a href="https://github.com/yishan-io/yishan-mono/actions/workflows/release.yml"><img src="https://github.com/yishan-io/yishan-mono/actions/workflows/release.yml/badge.svg" alt="Release" /></a>
  <a href="https://github.com/yishan-io/yishan-mono/stargazers"><img src="https://img.shields.io/github/stars/yishan-io/yishan-mono?style=social" alt="GitHub stars" /></a>
</p>

**Yishan helps agents know your projects better.**

Spend less time explaining. More time deciding.

<p align="center">
  <img src="https://raw.githubusercontent.com/yishan-io/yishan-mono/main/apps/landing/public/app.png" alt="Yishan — from zero to multiple parallel workstreams" width="100%" />
</p>

## Why Yishan?

Every time you start a new agent session, you repeat the same context — project structure, conventions, decisions already made. The burden of explanation falls on you, every time.

Yishan gives agents persistent project memory, shared context, and repeatable workflows. They find what they need on their own. You stop repeating yourself.

## Core Features

- **Isolated workspaces** — each task gets its own branch, terminal, and file state. Switch between tasks without losing anything.
- **Memory that grows with your project** — `.my-context` and built-in memory accumulate decisions, notes, and session summaries automatically. Agents find context on their own.
- **Skills that remove the ceremony** — define how you work once — review patterns, test rules, handoff steps. Every agent follows the same playbook, every time.

## More

- **Autopilot** — schedule recurring agent jobs on a cadence — code reviews, health checks, weekly summaries — running automatically while you focus elsewhere.
- **PR visibility** — see pull request state, checks, and review status without leaving Yishan.
- **Works with your tools** — open files in VS Code, Cursor, JetBrains, Sublime, Xcode, and more. Yishan bridges to your tools instead of replacing them.
- **Bring your own agent** — works with OpenCode, Claude, Codex, Gemini, Cursor, and Pi. Use the agents you already know.

## Roadmap

- Remote host workspaces — run workstreams on a remote machine *(in progress)*
- CLI + agent workflow integration — spawn multiple workspaces from chat or CLI *(in progress)*
- Development lifecycle management — issue to workspace to PR in one flow *(planned)*
- Mobile remote control — monitor and steer workspaces from your phone *(planned)*

## Getting Started

**Download for macOS** at [yishan.io](https://yishan.io).

To build from source and contribute, see [CONTRIBUTING.md](https://github.com/yishan-io/yishan-mono/blob/HEAD/CONTRIBUTING.md).

## Links

- [Website](https://yishan.io)
- [Changelog](https://github.com/yishan-io/yishan-mono/releases)
- [Contributing](https://github.com/yishan-io/yishan-mono/blob/HEAD/CONTRIBUTING.md)
- [License](https://github.com/yishan-io/yishan-mono/tree/HEAD/LICENSE)