← Back to Skills Marketplace
240
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install tidal-cli
Description
Control Tidal music streaming from the terminal. Use when the user wants to search Tidal's catalog (artists, albums, tracks, videos, playlists), manage playl...
Usage Guidance
This skill appears coherent: it installs an npm CLI and tells the agent to use that binary and its auth flow. Before installing, review the npm package (@lucaperret/tidal-cli) source or its npm page to confirm the publisher is trustworthy. Be aware that 'tidal-cli auth' will open your browser and store session credentials at ~/.tidal-cli/session.json — protect that file like any credential. Examples use jq and recommend rendering cover images; ensure you have jq or equivalent tooling if you want to run the provided pipelines. Finally, because third-party npm packages can run arbitrary code during install, consider auditing the package or installing in a controlled environment if you do not trust the publisher.
Capability Analysis
Type: OpenClaw Skill
Name: tidal-cli
Version: 1.1.2
The skill bundle provides a legitimate interface for the `tidal-cli` tool (npm package `@lucaperret/tidal-cli`) to manage Tidal music streaming. It includes standard commands for authentication, searching, and playlist management. The instructions in SKILL.md are well-structured for an AI agent, focusing on programmatic access via JSON and providing helpful usage patterns without any signs of malicious intent, data exfiltration, or harmful prompt injection.
Capability Assessment
Purpose & Capability
The skill is a Tidal CLI wrapper and requires the tidal-cli binary; the install spec (npm package @lucaperret/tidal-cli that provides tidal-cli) is consistent with the description and expected functionality.
Instruction Scope
Runtime instructions are focused on Tidal operations (search, playlists, playback). They explicitly instruct the user to run 'tidal-cli auth' which opens a browser and persists credentials to ~/.tidal-cli/session.json (expected for an OAuth-like flow). Example workflows use jq for JSON manipulation and show how to fetch playback URLs — jq is not listed as a required binary and image rendering is suggested, so the agent/operator should ensure those client-side tools/support exist. The instructions do not direct data to unexpected external endpoints beyond Tidal/auth flow.
Install Mechanism
Install uses a named npm package (@lucaperret/tidal-cli) to create the tidal-cli binary. This is a standard mechanism for delivering a CLI via Node; it is moderate-risk by nature of third-party packages but is proportionate for a CLI skill.
Credentials
The skill requests no environment variables or unrelated credentials. It does write session credentials to ~/.tidal-cli/session.json as part of normal auth; no broad or unrelated secrets are requested.
Persistence & Privilege
The skill is not marked always:true and does not request system-wide configuration changes. Its persistent footprint is the session file in the user's home directory (expected for CLI auth). Autonomous invocation (default) is allowed but not combined with other concerning capabilities.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install tidal-cli - After installation, invoke the skill by name or use
/tidal-cli - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.2
No user-facing changes detected in this version.
- Version bumped to 1.1.2.
- No file or documentation changes.
v1.1.1
- Changed the npm install package from @lucanova/tidal-cli to @lucaperret/tidal-cli.
- Added instruction that `track info` and `album info` return a `coverUrl` field (640x640 JPEG) and should always display the cover art image to users.
v1.0.1
Declare tidal-cli binary dependency and npm install source in metadata
v1.0.0
Initial release of tidal-cli.
- Control Tidal music streaming directly from the terminal.
- Search Tidal’s catalog (artists, albums, tracks, videos, playlists) with JSON output.
- Manage playlists: create, rename, delete, add or remove tracks/albums.
- Add or remove artists, albums, or tracks from your library/favorites.
- Play tracks with selectable quality, and retrieve playback info or stream URLs.
- Discover similar artists/tracks and receive personalized recommendations.
- View user profile and music account details.
- Includes agent usage patterns and clear error reporting with exit codes.
Metadata
Frequently Asked Questions
What is Tidal CLI?
Control Tidal music streaming from the terminal. Use when the user wants to search Tidal's catalog (artists, albums, tracks, videos, playlists), manage playl... It is an AI Agent Skill for Claude Code / OpenClaw, with 240 downloads so far.
How do I install Tidal CLI?
Run "/install tidal-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Tidal CLI free?
Yes, Tidal CLI is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Tidal CLI support?
Tidal CLI is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Tidal CLI?
It is built and maintained by Luca (@lucaperret); the current version is v1.1.2.
More Skills