MusePi

Desktop-first AI coding agent

MusePi

An Electron desktop GUI, an always-on desktop pet, a mobile companion and a daemon service on top of the oh-my-pi agent engine. Chinese-first, frosted-glass, keyboard-driven.

Download macOS Download Windows Windows ARM64 Download Linux Read the docs
v0.4.19 macOS · Windows · Linux · Android · HarmonyOS

One engine. Every surface.

Pick the surface that fits the moment — every one of them talks to the same daemon, the same sessions, the same settings.

Desktop client

The full cockpit — frosted-glass GUI, session-tree canvas, floating status cards and the always-on pet.

Terminal TUI

The same agent in your terminal — keyboard-first, SSH-friendly, identical sessions and settings.

Mobile companion

An Android app that pairs over LAN with a QR join — watch runs, send prompts and stop turns from anywhere.

Desktop GUI

A frosted-glass cockpit for your agent

Three-pane layout on a real frosted-glass window material (Win11 acrylic / macOS vibrancy), with chat and the session-tree-map as first-class surfaces.

  • Every TUI setting merged into one searchable panel
  • Floating status cards for running tasks
  • Keyboard-driven throughout, Chinese-first typography
MusePi welcome screen
Welcome — dot-matrix brand backdrop, time-aware greeting

Sessions as a tree

Every answer grows on a tree

Every message carries its parent — so history is a tree you can walk, not a log you must replay.

  • Branch, fork, revert and re-answer from any node
  • The canvas map draws the whole conversation DAG
  • The trajectory panel projects the same tree as a timeline
MusePi session view
Session — transcript, context donut, floating status cards

Agent engine & extensions

An engine you can rebuild mid-flight

Everything is pluggable: model providers, tools, UI surfaces — hot-reloaded while the daemon watches your extension folders.

  • 40+ LLM providers, image & video generation built in
  • Browser + computer-use tools, LSP/DAP, task subagents
  • Two extension centers with slots, tool views, RPCs, themes
MusePi settings panel
Settings — every TUI setting, searchable and grouped

Always-on pet

An animated companion with drag positioning, click-through, hover interactions and task bubbles — the agent's status at a glance.

Remote & mobile

Guests manage sessions and stop running turns remotely (E2E-encrypted collab); the Android companion pairs over LAN with QR join and a three-in-one send bar.

Download

Three ways to run MusePi — pick the surface that fits. Desktop builds are tagged releases with in-app auto-update; the TUI installs from npm; Android pairs with your desktop daemon over LAN.

Desktop client

Electron GUI · frosted-glass window · auto-update

Android companion

Capacitor app · LAN pairing · remote control

Terminal TUI

The full agent surface in your terminal

curl -fsSL https://raw.githubusercontent.com/MuseLinn/MusePi/main/scripts/install.sh | sh   # macOS / Linux / WSL
git clone https://github.com/MuseLinn/MusePi.git && cd MusePi
bun run setup && bun run musepi   # Windows · from source

Requires Node ≥ 22 or Bun. Same sessions, same daemon, same settings as the desktop app.

Every release ships an update-manifest.json for in-app auto-update; beta-channel builds publish as pre-releases.

Quick start (from source)

git clone https://github.com/MuseLinn/MusePi.git && cd MusePi
bun run setup                  # install + natives + link
bun run musepi                 # terminal TUI
bun run --cwd=packages/gui desktop   # desktop GUI

The full guide lives in README.md — daemon architecture, provider setup, mobile build, collab sharing.

Documentation

Bring the agent to your desktop

Free and open source. Minutes to install, a daemon that stays with you.

Download MusePi GitHub