# Piano

Music · Desktop app · Agent Workbench

A desktop piano built to be driven from Claude Code. Its plugin brings an MCP server that writes, checks and keeps scores, then opens the app to play them: the notes fall onto the keyboard, and practice mode waits for you on MIDI or the computer keys, loops a bar and says how each one went.

- Platform: Windows, macOS and Linux
- Licence: MIT
- Product site: https://alegauss.github.io/piano/
- Download: https://github.com/alegauss/piano/releases/latest
- Source: https://github.com/alegauss/piano

Public numbers as of 2026-10-20: latest release v0.1.0 (2026-09-23).

## Install

Claude Code plugin:

```
/plugin marketplace add alegauss/alegauss.github.io
/plugin install piano@alegauss
```

From source:

```
git clone https://github.com/alegauss/piano.git
cd piano
npm ci
npm run dev
```

## What comes next

From docs/ROADMAP.md at 51ba9d7.

### Block A — Foundation: Electron, TypeScript, React and shadcn

- 📋 An unsigned build trips SmartScreen and Gatekeeper, so a new user meets a warning before the app

## Recently shipped

- 2026-09-23 · PI111: Piano has no public page, README or LICENSE, so nobody finds it and the MIT claim points at no file
- 2026-09-23 · PI110: no installer survives the release workflow, so v0.1.0 cannot be published
- 2026-09-22 · PI109: A chosen option is told from the ones beside it by the weight of its text, which reads as no difference
- 2026-09-22 · PI108: Open recent still offers a deleted piece, and the system's own list still offers one at the path it has moved from
- 2026-09-22 · PI107: Deleting or retitling from chat skips the bin and leaves the practice records behind, where the panel does neither
- 2026-09-22 · PI106: Open recent names a piece by the title it had when it was opened, so a corrected one is listed under its old name
- 2026-09-22 · PI105: Tidying a library that grew by the batch means opening, confirming and closing one row at a time
- 2026-09-22 · PI104: Claude Code can write a score into the library but never remove one, nor correct what one says without rewriting it

All entries: https://alegauss.github.io/changelog/piano/