# zlib A Z-Library CLI to search, download, and send books to Kindle,
for you and AI agents like Claude Code and Codex. English | [简体中文](https://github.com/heartleo/zlib/blob/HEAD/README.zh.md) [Install](#install) · [Quick start](#quick-start) · [Terminal interface](#terminal-interface) · [Commands](#commands) · [Agent setup](#agent-setup) · [Docs](#documentation)

Features

🔍 Search — filter by year, language, and format; sort results\ 📚 Browse — favorites, recommendations, popular books, and download history\ 📥 Download — view book details and choose a download directory\ 📖 Send to Kindle — deliver files to your Kindle address\ 🕒 Profile — check your daily download quota\ 🎨 Themes — switch color themes with /theme\ 🌐 Network — find working mirrors with zlib doctor, trust your own mirror, or use a proxy\ 🤖 AI Agent Integration — integrate with Claude Code and Codex through Agent plugins

Install

macOS / Linux with Homebrew:

brew install heartleo/tap/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 and put it on your PATH. See Installation for Go installation, source builds, and upgrades.

Quick start

You need a Z-Library account. First, find a domain reachable from your network:

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:

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. Existing browser sessions can be imported as cookies.

Terminal interface

zlib tui opens one persistent shell. Every screen lists its keys at the bottom; these cover a first session:

Settings live under /config (network, downloads, Kindle). See Terminal interface for every screen and key.

Commands

Pass a query for table output, or add --json for scripts:

zlib search "dune" --ext epub
zlib search "dune" --ext epub --json --count 10

To download, replace id:hash with a book's complete id from the results:

zlib download "id:hash"

Run zlib <command> --help for flags. Usage covers filters, pagination, and download options.

Agent setup

Install the plugin, or register the MCP server (zlib mcp). If zlib is missing, the plugin installs it on first use. Log in yourself with zlib login so your password stays out of chat.

Claude Code

Plugin:

/plugin marketplace add heartleo/zlib
/plugin install zlib@zlib-plugin-cc

Codex

Plugin:

codex plugin marketplace add heartleo/zlib
codex plugin add zlib@zlib

MCP server

Register zlib mcp as a local stdio server. zlib must be on PATH and signed in:

# Claude Code
claude mcp add -s user zlib -- zlib mcp

# Codex
codex mcp add zlib -- zlib mcp

Add --read-only after mcp to hide download, history deletion, and Kindle delivery. See MCP server for other clients, flags, and tools.

Documentation

Report bugs in Issues with your zlib version, OS, command, and error. Omit passwords, cookies, and session files. Report security vulnerabilities privately as described in SECURITY.md.

Star History