# muse-cli: reconstructing the muse.ai personal gateway protocol

> muse-cli implements terminal access to the muse.ai personal gateway using behavior derived from its web client bundle. It obtains access tokens over HTTPS, connects to a personal VM through a Noise-XX WebSocket, and exchanges protobuf-framed requests and events. The accompanying notes document transport framing and gateway methods.

- Type: Case study
- Targets: Protocol · Website
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-09
- Original resource: <https://github.com/nikships/muse-cli>
- Primary source: <https://github.com/nikships/muse-cli/blob/2e42aeccbef71437f4ccd4faa626414f2461be7b/docs/PROTOCOL.md>
- Catalog page: <https://awesomerea.org/resources/muse-cli-case/>
- Record JSON: <https://awesomerea.org/resources/muse-cli-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/muse-cli-case/index.md)

## Requirements & limits

- **Prerequisites:** Python 3.10 or newer and an existing muse.ai browser login are required.
- **Scope:** Direct browser-cookie export supports Chromium-based browsers on macOS; other systems use agent-browser or manual cookie export.
- **Limits:** The gateway API is unversioned and may change.
- **License:** MIT license.

## Primary sources

1. <https://github.com/nikships/muse-cli/blob/2e42aeccbef71437f4ccd4faa626414f2461be7b/docs/PROTOCOL.md>
2. <https://github.com/nikships/muse-cli/blob/2e42aeccbef71437f4ccd4faa626414f2461be7b/README.md>

## More in Websites

- [MAX Messenger: documenting WebSocket and TCP message formats](https://awesomerea.org/resources/max-messenger-protocol-case/index.md) · Case study
- [Tesla Dashcam Decryptor: decoding encrypted dashcam recordings](https://awesomerea.org/resources/tesla-dashcam-decrypt-case/index.md) · Case study
- [transferit-py: reconstructing transfer.it upload and download exchanges](https://awesomerea.org/resources/transferit-py-case/index.md) · Case study
- [github-websocket-pipelines-api: probing GitHub Actions live-log messages](https://awesomerea.org/resources/github-websocket-pipelines-api-case/index.md) · Case study
- [Inception Chat: reconstructing a chat page from design and prompt captures](https://awesomerea.org/resources/inception-chat-extraction-case/index.md) · Case study
- [pipepipe-sabr: reconstructing YouTube SABR streaming](https://awesomerea.org/resources/pipepipe-sabr-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.