Muse Code GUIs for desktop and mobile

<!-- Improved compatibility of back to top link: See: https://github.com/othneildrew/Best-README-Template/pull/73 -->
<a id="readme-top"></a>

<!-- PROJECT SHIELDS -->
[![Contributors][contributors-shield]][contributors-url]
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
[![Issues][issues-shield]][issues-url]

<!-- PROJECT LOGO -->
<br />
<div align="center">

  <h3 align="center">muse-code-gui</h3>

  <p align="center">
    Graphical frontends for Muse Code that run on your subscription — Windows, macOS, iOS, Android.
    <br />
    <a href="https://github.com/aminamos/muse-code-gui/tree/main/docs"><strong>Explore the docs »</strong></a>
    <br />
    <br />
    <a href="https://github.com/aminamos/muse-code-gui/issues/new?labels=bug">Report Bug</a>
    &middot;
    <a href="https://github.com/aminamos/muse-code-gui/issues/new?labels=enhancement">Request Feature</a>
  </p>
</div>

<!-- TABLE OF CONTENTS -->
<details>
  <summary>Table of Contents</summary>
  <ol>
    <li>
      <a href="#about-the-project">About The Project</a>
      <ul>
        <li><a href="#built-with">Built With</a></li>
      </ul>
    </li>
    <li>
      <a href="#getting-started">Getting Started</a>
      <ul>
        <li><a href="#prerequisites">Prerequisites</a></li>
        <li><a href="#installation">Installation</a></li>
      </ul>
    </li>
    <li><a href="#usage">Usage</a></li>
    <li><a href="#roadmap">Roadmap</a></li>
    <li><a href="#contributing">Contributing</a></li>
    <li><a href="#contact">Contact</a></li>
    <li><a href="#acknowledgments">Acknowledgments</a></li>
    <li><a href="#for-ai-agents">For AI Agents</a></li>
  </ol>
</details>

<!-- ABOUT THE PROJECT -->
## About The Project

Four GUI apps plus one relay server. Every run executes through `muse` on the
relay host, inheriting its subscription login — no API key exists anywhere in
the system.

* **Apps:** Expo + TypeScript for iOS/Android (remote-relay-only), Tauri v2 +
  React + Vite for Windows/macOS (localhost relay default).
* **Relay:** one Deno server — the only exec/transcribe engine. Exec over SSE,
  transcription with speaker diarization, RSS podcast flow, document ingest
  (txt/md/epub/pdf), MCP tools, and an OpenAI-compatible provider endpoint.
* Every harness option (OMP, OpenCode, Claude Code, Codex, Command Code) talks
  to the same relay, so spend always land