v0.4.0 Stable

Precision Music Controller for Hackers

A terminal-native controller built on top of MPRIS protocol and the lightweight mpv playback engine. Integrated with beets library sync and tailored Skill contexts for AI agents.

alx terminal - session

Install via npm / bun (Recommended)

Prebuilt binaries since v0.4.0 — one command, no Rust toolchain required (external mpv still needed):

npm:
npm install -g agent-lx-music
Bun:
bun add -g agent-lx-music

Supported on Linux x64/arm64 (glibc) and macOS x64/arm64; Windows pending (#184) — use Cargo or direct Releases download meanwhile.

Linux Setup & Package Managers

Deploy pre-compiled static binaries dynamically, via AUR, or build directly from Crates.io:

Rust Cargo (Crates.io - 推荐):
cargo install agent-lx-music
Arch Linux (AUR):
yay -S agent-lx-music
Debian/Ubuntu/Fedora/Alpine (Shell Script):
curl -sSL https://raw.githubusercontent.com/Xuepoo/agent-lx-music/main/install.sh | bash

💡 You can also visit our Releases page to download native system installers (including .deb for Debian/Ubuntu, .rpm for Fedora/RHEL, and .tar.gz for generic Linux).

Browse Releases ARM64 编译包

macOS Setup & Homebrew

Deploy natively on Apple Silicon or Intel chips via Homebrew Tap:

Homebrew Tap:
brew install xuepoo/tap/agent-lx-music
下载 macOS Apple Silicon (ARM64) Intel (x86_64)

Windows Static Executable

Grab portable static executable pre-compiled for PowerShell & Command Prompt environments:

Scoop Package:
scoop bucket add xuepoo && scoop install agent-lx-music
下载 Windows x64.exe

Engineered for Developers and AI Agents

agent-lx-music (alx) strips away the bloat of GUI desktop players, bridging directly to a lightweight system audio engine. It yields sub-millisecond CLI response times alongside search catalogs, queue pipelines, and local caching.

By exposing standard MPRIS contracts to the local D-Bus, it coexists harmoniously with OS media widgets and provides a robust, real-time context stream for LLM agents running in your shell.

Empower AI Agents with Music Skill Contexts

Expose native interface schemas for Hermes, OpenClaw, and Codex, unlocking real-time search, queue, and daemon integration.

alx mcp New in v0.4.0: built-in Model Context Protocol server — LLM agents drive playback, search & library over stdio
alx mcp
npx skills Install seamlessly via Vercel Skills
npx skills add https://github.com/Xuepoo/agent-lx-music-skills/tree/main/agent-lx-music

Core Playback Controller Skill

The foundation controller. Bundles actions for play, pause, skip, volume adjustment, and state queries to drive the player from an agent environment.

agent-lx-music

Music Discovery & Charts Skill

Fetch hot charts, editorial playlists, and personalized musical suggestions. Empowers LLMs to select background tracks based on system load or mood.

music-discovery

Lyrical Metadata & Album Art Skill

Track cover downloads and scrollable lyric parsers. Feeds granular time-stamped text structures and image paths into LLM rendering engines.

audio-analysis

Listening Companion & Daemon Skill

Active daemon watchers tracking process life cycles and playback stats. Helps your AI agent dynamically comment on songs and structure playlist logs.

listening-companion
MIT License Rust Refactored

Open Source Multimedia Ecosystem

The alx engine is born as a tribute and high-performance rewrite of the legendary lx-music-desktop project. We re-engineered its core music-sourcing behaviors into an ultra-fast Rust CLI using system MPRIS, expanding it with native Agent Skills.

Source Code Skills Hub