Skip to content
Back to search

zlib-plugin-cc

MarketplaceWorks with Claude CodeGitHub

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/heartleo--zlib/badge.svg)](/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
  1. {
  2. "name": "zlib-plugin-cc",
  3. "metadata": {
  4. "description": "Give Claude a Z-Library client. /zlib searches, downloads, and send to Kindle; /zlib:metadata fixes e-book metadata."
  5. },
  6. "owner": {
  7. "name": "heartleo"
  8. },
  9. "plugins": [
  10. {
  11. "name": "zlib",
  12. "source": "./plugins/zlib",
  13. "description": "Search and download books, send to Kindle, look up and edit e-book metadata.",
  14. "category": "productivity"
  15. }
  16. ]
  17. }
README.md · README · 231 lines · 1 finding marked
  1. <div align="center">
  2. <picture>
  3. <source media="(prefers-color-scheme: dark)" srcset="docs/logo-dark-theme.svg">
  4. <source media="(prefers-color-scheme: light)" srcset="docs/logo-light-theme.svg">
  5. <img src="docs/logo-light-theme.svg" alt="zlib" width="260">
  6. </picture>
  7. A Z-Library CLI for you and your AI agents.
  8. <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>
  9. <a href="https://trendshift.io/repositories/135168?utm_source=repository-badge&amp;utm_medium=badge&amp;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>
  10. English | [简体中文](README.zh.md)
  11. [Install](#install) · [Quick start](#quick-start) · [Terminal interface](#terminal-interface) · [Commands](#commands) · [Agent setup](#agent-setup) · [Docs](#documentation)
  12. </div>
  13. <picture>
  14. <source media="(prefers-color-scheme: dark)" srcset="docs/search.gif">
  15. <source media="(prefers-color-scheme: light)" srcset="docs/search-light.gif">
  16. <img src="docs/search.gif" width="100%" alt="Book search in the terminal">
  17. </picture>
  18. ## Features
  19. 🔍 **Search** — filter by year, language, and format; sort results\
  20. 📚 **Browse** — favorites, recommendations, popular books, and download history\
  21. 📥 **Download** — view book details, choose a download directory\
  22. 🖼️ **Covers** — show book [covers](docs/covers.md) in the terminal\
  23. 🏷️ **Metadata** — look up and edit e-book [metadata](docs/metadata.md)\
  24. 📖 **Send to Kindle** — deliver files to your [Kindle address](docs/kindle.md)\
  25. 🌏 **Send to WeRead** — import books into your [WeRead](docs/weread.md) shelf\
  26. 🕒 **Profile** — check your daily download quota\
  27. 🎨 **Themes** — change the color theme\
  28. 🌐 **Network** — check which mirrors work, trust [your own mirror](docs/configuration.md#your-own-mirrors), or use a proxy\
  29. 🤖 **AI Agent Integration** — integrate with Claude Code and Codex through [Agent plugins](#agent-setup)
  30. ## Install
  31. macOS / Linux with Homebrew:
  32. ```bash
  33. brew install heartleo/tap/zlib-cli
  34. ```
  35. > [!IMPORTANT]
  36. > The Homebrew formula was renamed from `zlib` to **`zlib-cli`**.
  37. > Use the command above. The installed command is still `zlib`.
  38. macOS / Linux with the install script (installs to `/usr/local/bin`, may ask for `sudo`):
  39. ```bash
  40. 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
  41. ```
  42. Windows with winget:
  43. ```powershell
  44. winget install --id heartleo.zlib --exact
  45. ```
  46. Or download a binary from [Releases](https://github.com/heartleo/zlib/releases/latest)
  47. and put it on your `PATH`. See [Installation](docs/installation.md) for Go
  48. installation, source builds, and upgrades.
  49. ## Quick start
  50. You need a Z-Library account. First, find a domain reachable from your network:
  51. ```sh
  52. zlib doctor
  53. ```
  54. Log in with a domain from the results. Replace the example URL below with one
  55. from your results; enter your email and password in the prompt:
  56. ```sh
  57. zlib login --domain https://z-lib.gd
  58. zlib tui
  59. ```
  60. Press `/`, choose `/search`, enter a title, author, or ISBN, and press `Ctrl+S`.
  61. You can also type `/search dune` and press `Enter`. Select a book and press `Enter`
  62. to confirm the download.
  63. Downloads default to the current directory. You can choose another folder before
  64. downloading. Login is saved locally; subsequent sessions only need `zlib tui`.
  65. If no domain works or login fails, see [Troubleshooting](docs/troubleshooting.md).
  66. Existing browser sessions can be [imported as cookies](docs/troubleshooting.md#login-returns-authorization-failed).
  67. ## Terminal interface
  68. `zlib tui` opens one persistent shell. Every screen lists its keys at the bottom;
  69. these cover a first session:
  70. | Key | Action |
  71. | -------------- | ---------------------------------------------------------------------------- |
  72. | `/` | Open the command list: search, favorites, history, profile, metadata, settings, themes |
  73. | `↑/↓` or `j/k` | Select a book |
  74. | `←/→` | Previous or next page of results |
  75. | `Enter` | Download the selected book, after a confirmation |
  76. | `Ctrl+F` | Change the query and filters of the current search |
  77. | `Esc` | Go back |
  78. | `/quit` | Exit |
  79. On a terminal with Kitty graphics or Sixel support, at least 100 columns by 20
  80. rows, the selected book's card shows its cover; other terminals show text only
  81. ([Book covers](docs/covers.md)). `/meta` opens a file picker, then looks the
  82. chosen e-book up online and lets you review each field before writing it. It
  83. needs no login ([E-book metadata](docs/metadata.md)).
  84. Settings live under `/config` (network, downloads, search formats, metadata, Kindle, WeRead). See
  85. [Terminal interface](docs/tui.md) for every screen and key.
  86. ## Commands
  87. Pass a query for table output, or add `--json` for scripts:
  88. ```sh
  89. zlib search "dune" --ext epub
  90. zlib search "dune" --ext epub --json --count 10
  91. ```
  92. | Task | Command |
  93. | -------------------------------- | ------------------------------ |
  94. | Browse favorites | `zlib favorites` |
  95. | Browse recommendations | `zlib recommended` |
  96. | Browse popular books | `zlib most-popular` |
  97. | Browse download history | `zlib history` |
  98. | Check account and quota | `zlib profile` |
  99. | Send to [Kindle](docs/kindle.md) | `zlib kindle send ./book.epub` |
  100. | Send to [WeRead](docs/weread.md) | `zlib weread import ./book.epub` |
  101. | Show a file's [metadata](docs/metadata.md) | `zlib meta book.epub` |
  102. | Look up a file's metadata | `zlib meta book.epub --fetch` |
  103. | Edit a file's metadata | `zlib meta book.epub -t "Dune" -a "Frank Herbert" --rename` |
  104. To download, replace `id:hash` with a book's complete `id` from
  105. the results:
  106. ```sh
  107. zlib download "id:hash"
  108. ```
  109. Run `zlib <command> --help` for flags. [Usage](docs/usage.md) covers filters,
  110. pagination, and download options.
  111. ## Agent setup
  112. Install the plugin, or register the MCP server (`zlib mcp`). The plugin brings
  113. the skills and the MCP server. If `zlib` is missing, the skills install it on
  114. first use; the MCP server needs it on `PATH`. Log in yourself with `zlib login`
  115. so your password stays out of chat.
  116. ### Claude Code
  117. Plugin:
  118. ```text
  119. /plugin marketplace add heartleo/zlib
  120. /plugin install zlib@zlib-plugin-cc
  121. ```
  122. ### Codex
  123. Plugin:
  124. ```sh
  125. codex plugin marketplace add heartleo/zlib
  126. codex plugin add zlib@zlib
  127. ```
  128. ### Grok
  129. Plugin:
  130. ```sh
  131. grok plugin marketplace add heartleo/zlib
  132. grok plugin install zlib --trust
  133. ```
  134. ### MCP server
  135. Register `zlib mcp` as a local stdio server. `zlib` must be on `PATH` and signed in:
  136. ```sh
  137. # Claude Code
  138. claude mcp add -s user zlib -- zlib mcp
  139. # Codex
  140. codex mcp add zlib -- zlib mcp
  141. # Grok
  142. grok mcp add zlib -- zlib mcp
  143. ```
  144. Add `--read-only` after `mcp` to hide download, history deletion, Kindle
  145. delivery, WeRead import and metadata editing. See [MCP server](docs/mcp.md) for other clients, flags, and tools.
  146. ## Documentation
  147. | Guide | Covers |
  148. | ------------------------------------------ | ---------------------------------------------- |
  149. | [Installation](docs/installation.md) | Install methods, source builds, `zlib update` |
  150. | [Usage](docs/usage.md) | Search, downloads, favorites, history |
  151. | [Terminal interface](docs/tui.md) | Commands and keyboard controls |
  152. | [Book covers](docs/covers.md) | Supported terminals, limits and cache |
  153. | [E-book metadata](docs/metadata.md) | Lookup sources, editing, renaming, formats |
  154. | [Configuration](docs/configuration.md) | Domains, proxies, folders, configuration paths |
  155. | [Themes](docs/themes.md) | Available palettes and preview controls |
  156. | [Kindle](docs/kindle.md) | SMTP setup and delivery |
  157. | [WeRead](docs/weread.md) | QR login and imports into WeRead |
  158. | [MCP server](docs/mcp.md) | Client setup, flags, and tools for `zlib mcp` |
  159. | [Troubleshooting](docs/troubleshooting.md) | Login and network problems |
  160. Report bugs in [Issues](https://github.com/heartleo/zlib/issues) with your
  161. `zlib version`, OS, command, and error. Omit passwords, cookies, and session files.
  162. Report security vulnerabilities privately as described in [SECURITY.md](.github/SECURITY.md).
  163. ## Star History
  164. <a href="https://www.star-history.com/?repos=heartleo%2Fzlib&type=date&logscale=&legend=top-left">
  165. <picture>
  166. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=heartleo/zlib&type=date&theme=dark&logscale&legend=top-left" />
  167. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=heartleo/zlib&type=date&logscale&legend=top-left" />
  168. <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=heartleo/zlib&type=date&logscale&legend=top-left" />
  169. </picture>
  170. </a>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.