zlib-plugin-cc
A command-line tool for Z-Library. Search, download, send to Kindle and WeRead, and integrate with AI agents.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/heartleo--zlib)HTML
<a href="/listings/heartleo--zlib"><img src="/api/listings/heartleo--zlib/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
These steps run a script from the network that findsafeskills does not scan.
macOS / Linux with Homebrew:
brew install heartleo/tap/zlib-cli
> [!IMPORTANT] > The Homebrew formula was renamed from `zlib` to **`zlib-cli`**. > Use the command above. The installed command is still `zlib`.
macOS / Linux with the install script (installs to `/usr/local/bin`, may ask for `sudo`):
curl -fsSL https://raw.githubusercontent.com/heartleo/zlib/main/install.sh | sh
Windows with winget:
winget install --id heartleo.zlib --exact
Or download a binary from [Releases](https://github.com/heartleo/zlib/releases/latest) and put it on your `PATH`. See [Installation](docs/installation.md) for Go installation, source builds, and upgrades.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 17 lines
- {
- "name": "zlib-plugin-cc",
- "metadata": {
- "description": "Give Claude a Z-Library client. /zlib searches, downloads, and send to Kindle; /zlib:metadata fixes e-book metadata."
- },
- "owner": {
- "name": "heartleo"
- },
- "plugins": [
- {
- "name": "zlib",
- "source": "./plugins/zlib",
- "description": "Search and download books, send to Kindle, look up and edit e-book metadata.",
- "category": "productivity"
- }
- ]
- }
README.md · README · 231 lines · 1 finding marked
- <div align="center">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="docs/logo-dark-theme.svg">
- <source media="(prefers-color-scheme: light)" srcset="docs/logo-light-theme.svg">
- <img src="docs/logo-light-theme.svg" alt="zlib" width="260">
- </picture>
- A Z-Library CLI for you and your AI agents.
- <a href="go.mod"><img src="https://img.shields.io/github/go-mod/go-version/heartleo/zlib" alt="Go version" height="20"/></a> <a href="https://github.com/heartleo/zlib/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/heartleo/zlib/ci.yml" alt="CI" height="20"/></a> <a href="https://github.com/heartleo/zlib/releases/latest"><img src="https://img.shields.io/github/v/release/heartleo/zlib" alt="Release" height="20"/></a> <a href="https://github.com/heartleo/zlib/releases"><img src="https://img.shields.io/github/downloads/heartleo/zlib/total" alt="Downloads" height="20"/></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License" height="20"/></a>
- <a href="https://trendshift.io/repositories/135168?utm_source=repository-badge&utm_medium=badge&utm_campaign=badge-repository-135168" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/135168" alt="heartleo%2Fzlib | Trendshift" width="250" height="55"/></a>
- English | [简体中文](README.zh.md)
- [Install](#install) · [Quick start](#quick-start) · [Terminal interface](#terminal-interface) · [Commands](#commands) · [Agent setup](#agent-setup) · [Docs](#documentation)
- </div>
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="docs/search.gif">
- <source media="(prefers-color-scheme: light)" srcset="docs/search-light.gif">
- <img src="docs/search.gif" width="100%" alt="Book search in the terminal">
- </picture>
- ## Features
- 🔍 **Search** — filter by year, language, and format; sort results\
- 📚 **Browse** — favorites, recommendations, popular books, and download history\
- 📥 **Download** — view book details, choose a download directory\
- 🖼️ **Covers** — show book [covers](docs/covers.md) in the terminal\
- 🏷️ **Metadata** — look up and edit e-book [metadata](docs/metadata.md)\
- 📖 **Send to Kindle** — deliver files to your [Kindle address](docs/kindle.md)\
- 🌏 **Send to WeRead** — import books into your [WeRead](docs/weread.md) shelf\
- 🕒 **Profile** — check your daily download quota\
- 🎨 **Themes** — change the color theme\
- 🌐 **Network** — check which mirrors work, trust [your own mirror](docs/configuration.md#your-own-mirrors), or use a proxy\
- 🤖 **AI Agent Integration** — integrate with Claude Code and Codex through [Agent plugins](#agent-setup)
- ## Install
- macOS / Linux with Homebrew:
- ```bash
- brew install heartleo/tap/zlib-cli
- ```
- > [!IMPORTANT]
- > The Homebrew formula was renamed from `zlib` to **`zlib-cli`**.
- > Use the command above. The installed command is still `zlib`.
- macOS / Linux with the install script (installs to `/usr/local/bin`, may ask for `sudo`):
- ```bash
- curl -fsSL https://raw.githubusercontent.com/heartleo/zlib/main/install.sh | sh
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 56 on GitHub
- ```
- Windows with winget:
- ```powershell
- winget install --id heartleo.zlib --exact
- ```
- Or download a binary from [Releases](https://github.com/heartleo/zlib/releases/latest)
- and put it on your `PATH`. See [Installation](docs/installation.md) for Go
- installation, source builds, and upgrades.
- ## Quick start
- You need a Z-Library account. First, find a domain reachable from your network:
- ```sh
- zlib doctor
- ```
- Log in with a domain from the results. Replace the example URL below with one
- from your results; enter your email and password in the prompt:
- ```sh
- zlib login --domain https://z-lib.gd
- zlib tui
- ```
- Press `/`, choose `/search`, enter a title, author, or ISBN, and press `Ctrl+S`.
- You can also type `/search dune` and press `Enter`. Select a book and press `Enter`
- to confirm the download.
- Downloads default to the current directory. You can choose another folder before
- downloading. Login is saved locally; subsequent sessions only need `zlib tui`.
- If no domain works or login fails, see [Troubleshooting](docs/troubleshooting.md).
- Existing browser sessions can be [imported as cookies](docs/troubleshooting.md#login-returns-authorization-failed).
- ## Terminal interface
- `zlib tui` opens one persistent shell. Every screen lists its keys at the bottom;
- these cover a first session:
- | Key | Action |
- | -------------- | ---------------------------------------------------------------------------- |
- | `/` | Open the command list: search, favorites, history, profile, metadata, settings, themes |
- | `↑/↓` or `j/k` | Select a book |
- | `←/→` | Previous or next page of results |
- | `Enter` | Download the selected book, after a confirmation |
- | `Ctrl+F` | Change the query and filters of the current search |
- | `Esc` | Go back |
- | `/quit` | Exit |
- On a terminal with Kitty graphics or Sixel support, at least 100 columns by 20
- rows, the selected book's card shows its cover; other terminals show text only
- ([Book covers](docs/covers.md)). `/meta` opens a file picker, then looks the
- chosen e-book up online and lets you review each field before writing it. It
- needs no login ([E-book metadata](docs/metadata.md)).
- Settings live under `/config` (network, downloads, search formats, metadata, Kindle, WeRead). See
- [Terminal interface](docs/tui.md) for every screen and key.
- ## Commands
- Pass a query for table output, or add `--json` for scripts:
- ```sh
- zlib search "dune" --ext epub
- zlib search "dune" --ext epub --json --count 10
- ```
- | Task | Command |
- | -------------------------------- | ------------------------------ |
- | Browse favorites | `zlib favorites` |
- | Browse recommendations | `zlib recommended` |
- | Browse popular books | `zlib most-popular` |
- | Browse download history | `zlib history` |
- | Check account and quota | `zlib profile` |
- | Send to [Kindle](docs/kindle.md) | `zlib kindle send ./book.epub` |
- | Send to [WeRead](docs/weread.md) | `zlib weread import ./book.epub` |
- | Show a file's [metadata](docs/metadata.md) | `zlib meta book.epub` |
- | Look up a file's metadata | `zlib meta book.epub --fetch` |
- | Edit a file's metadata | `zlib meta book.epub -t "Dune" -a "Frank Herbert" --rename` |
- To download, replace `id:hash` with a book's complete `id` from
- the results:
- ```sh
- zlib download "id:hash"
- ```
- Run `zlib <command> --help` for flags. [Usage](docs/usage.md) covers filters,
- pagination, and download options.
- ## Agent setup
- Install the plugin, or register the MCP server (`zlib mcp`). The plugin brings
- the skills and the MCP server. If `zlib` is missing, the skills install it on
- first use; the MCP server needs it on `PATH`. Log in yourself with `zlib login`
- so your password stays out of chat.
- ### Claude Code
- Plugin:
- ```text
- /plugin marketplace add heartleo/zlib
- /plugin install zlib@zlib-plugin-cc
- ```
- ### Codex
- Plugin:
- ```sh
- codex plugin marketplace add heartleo/zlib
- codex plugin add zlib@zlib
- ```
- ### Grok
- Plugin:
- ```sh
- grok plugin marketplace add heartleo/zlib
- grok plugin install zlib --trust
- ```
- ### MCP server
- Register `zlib mcp` as a local stdio server. `zlib` must be on `PATH` and signed in:
- ```sh
- # Claude Code
- claude mcp add -s user zlib -- zlib mcp
- # Codex
- codex mcp add zlib -- zlib mcp
- # Grok
- grok mcp add zlib -- zlib mcp
- ```
- Add `--read-only` after `mcp` to hide download, history deletion, Kindle
- delivery, WeRead import and metadata editing. See [MCP server](docs/mcp.md) for other clients, flags, and tools.
- ## Documentation
- | Guide | Covers |
- | ------------------------------------------ | ---------------------------------------------- |
- | [Installation](docs/installation.md) | Install methods, source builds, `zlib update` |
- | [Usage](docs/usage.md) | Search, downloads, favorites, history |
- | [Terminal interface](docs/tui.md) | Commands and keyboard controls |
- | [Book covers](docs/covers.md) | Supported terminals, limits and cache |
- | [E-book metadata](docs/metadata.md) | Lookup sources, editing, renaming, formats |
- | [Configuration](docs/configuration.md) | Domains, proxies, folders, configuration paths |
- | [Themes](docs/themes.md) | Available palettes and preview controls |
- | [Kindle](docs/kindle.md) | SMTP setup and delivery |
- | [WeRead](docs/weread.md) | QR login and imports into WeRead |
- | [MCP server](docs/mcp.md) | Client setup, flags, and tools for `zlib mcp` |
- | [Troubleshooting](docs/troubleshooting.md) | Login and network problems |
- Report bugs in [Issues](https://github.com/heartleo/zlib/issues) with your
- `zlib version`, OS, command, and error. Omit passwords, cookies, and session files.
- Report security vulnerabilities privately as described in [SECURITY.md](.github/SECURITY.md).
- ## Star History
- <a href="https://www.star-history.com/?repos=heartleo%2Fzlib&type=date&logscale=&legend=top-left">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=heartleo/zlib&type=date&theme=dark&logscale&legend=top-left" />
- <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=heartleo/zlib&type=date&logscale&legend=top-left" />
- <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=heartleo/zlib&type=date&logscale&legend=top-left" />
- </picture>
- </a>
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.