v0.2.1 Stable

为智能终端打造的音乐控制器

基于 MPRIS 协议与轻量 mpv 引擎构建的命令行音乐控制终端。深度集成 beets 本地曲库同步,并为 AI 代理开发伴听提供专属 Skill 上下文。

alx terminal - session

Linux 快速安装与发行版

支持通过 Cargo、AUR 或是单命令管道,将编译好的二进制文件安全部署到您的系统上:

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

💡 您也可以前往主仓库的 Releases 页面,直接下载为您打包好的发行版一键安装包(支持 Debian/Ubuntu 的 .deb 包,Fedora/RHEL 的 .rpm 包,及通用 Linux 的 .tar.gz 包)。

macOS 安装与 Homebrew

您可以通过 Homebrew tap 快速获取或直链下载已适配 Apple Silicon 及 Intel 的编译程序:

Homebrew Tap:
brew install xuepoo/tap/agent-lx-music

Windows 运行程序

我们为 Windows 终端系统提供了开箱即用的便携式单执行文件,支持 cmd/PowerShell 运行环境:

Scoop Package:
scoop bucket add xuepoo && scoop install agent-lx-music

专为系统工程师与智能代理设计

agent-lx-music (alx) 摒弃了传统图形化界面的臃肿,直连轻量化播放引擎。在保持极致响应速度的同时,提供多平台检索、播放队列管理以及音轨缓存优化功能。

通过向本地 D-Bus 接口暴露标准的 MPRIS 契约,它不仅能顺畅地与系统的多媒体小部件协作,还能通过标准格式输出让运行中的开发代理轻松感知您的音乐上下文,实现高度自动化的终端听歌交互。

为 AI 开发代理提供 Skill 上下文

支持 Hermes、OpenClaw 以及 Codex 等智能终端代理无缝集成,提供搜歌、切歌与状态巡检等标准运行 Skill。

npx skills 使用 Vercel Skills 无缝安装
npx skills add https://github.com/Xuepoo/agent-lx-music-skills/tree/main/agent-lx-music

播放控制核心 Skill

核心控制指令模块。提供播放、暂停、曲目切换、音量及循环模式调节的标准指令,使运行中的代理能够直接驱动底层的多媒体进程。

agent-lx-music

歌曲探索与排行 Skill

自动检索网络音乐排行榜与个性化推荐。支持排行榜拉取与智能歌单推荐,让开发代理能根据工作负载或心情智能切换背景音轨。

music-discovery

音轨分析与元数据 Skill

深度拉取滚动歌词、唱片封面等相关信息。在播放的同时自动解析歌词编码与本地封面缓存,供代理进行音乐解析与信息渲染。

audio-analysis

场景伴听与巡检 Skill

提供实时的音乐上下文感知与状态监听守护。在您专心编写代码时,代理将能够动态捕捉并推荐舒适的伴听建议与设备监控。

listening-companion

完全开源的极客曲库控制生态

alx 项目诞生于对经典桌面端 lx-music-desktop 架构生态的重构与致敬。我们尊重其自定义音源协议设计,并使用 Rust MPRIS 现代化命令行重构了其核心协议实现,进而拓展出面向 AI 代理的模块化运行生态。

MIT 开源许可协议 (MIT License)