📦 deeptide/ paean-ai

Install on macOS (recommended)

For Mac users, the recommended path is the native Deeptide build from deeptide.sh. It downloads the signed build for your Mac architecture and installs both deeptide and the shorter tide command:

curl -fsSL https://deeptide.sh/install.sh | sh

Then start with:

tide auth login   # Paean OAuth, multimodal-aware
tide login        # or save a DeepSeek API key directly
tide              # launch the REPL
tide doctor       # diagnose install + network

If you want a native Mac terminal to pair with Deeptide, also try Clide — a modern macOS terminal with file explorer, multi-pane layouts, drag-and-drop, and native voice input.

Install on Linux / Windows (Zero CLI alias)

Prerequisite: Bun must be installed and on PATH. The CLI runtime requires it (matches the underlying Zero CLI). Bun does not replace your Node install — it sits alongside.

On non-Mac systems, this npm package is the cross-platform DeepTide-flavored entrypoint powered by Zero CLI. It installs the deeptide and tide aliases for a workflow close to Deeptide, but it is not the Swift-native macOS build from deeptide.sh.

# bun (recommended, fastest install)
bun add -g deeptide

# npm (works too; bun is still required at runtime)
npm install -g deeptide

# pnpm
pnpm add -g deeptide

Two commands are installed; pick whichever your fingers prefer:

tide                          # interactive REPL (preferred — short)
deeptide                      # same thing, full name
tide -p "explain this repo"   # one-shot mode
tide --help                   # all options

You can also install the upstream package directly:

bun add -g @paean-ai/zero-cli

Quick start (CLI)

DeepTide CLI talks to the DeepSeek API by default (matching the DeepTide native app), and can also drive any Anthropic-protocol-compatible endpoint via BYOK — Zhipu GLM, Volcengine, Paean, Qwen, Moonshot, self-hosted gateways, and so on.

# Default path — DeepSeek
export DEEPSEEK_API_KEY="sk-..."
tide

# BYOK to another provider
tide --base-url https://open.bigmodel.cn/api/anthropic --api-key <GLM_KEY>

# One-shot, non-interactive
tide -p "Explain the auth middleware"

For the full configuration surface (settings.json schema, hooks, permissions, MCP servers, sub-agents, model aliases) see the upstream Zero CLI README, which is the authoritative reference.

---