SameBeat v0.1.0

Let the AI you already talk to know what you are listening to.

SameBeat is an AI-agnostic, read-only listening-presence layer for the official QQ Music Mac client. It exposes playback facts through four MCP tools: now_playing, recent_history, track_context, and listening_summary.

QQ Music remains the player and source of truth. SameBeat provides senses; OB or another independent system can provide memory; the AI makes judgments.

Scope

• macOS Agent with official QQ Music
• Self-hosted, single-user server
• Read-only MCP access
• Explicit unknown, stale, and estimated-state semantics
• Independent ingest and MCP credentials

Not included in v0.1.0

• Lyrics
• Playback controls
• Emotion inference
• Automatic memory writes
• Audio access or downloading

Validation

• 55 local tests passed
• GitHub Actions passed on the tagged commit
• Isolated Docker build, startup, and health check passed
• Real Mac reboot/autostart passed
• ChatGPT MCP end-to-end playback-state revalidation passed
• Release secret scan returned 0 findings

See README.md, docs/QUICKSTART.md, and HANDOFF.md for setup details, limitations, and validation scope.