deeptide

DeepTide

Built by DeepSeek, for DeepSeek.
An AI coding agent that flows through your codebase like a tide.
_{The name: DeepSeek + tide (terminal IDE).}

Two flavors, same team

	DeepTide for macOS	DeepTide CLI
Form factor	Native macOS app	Cross-platform terminal CLI
Runtime	Swift 6 native binary, ~15 MB idle	Bun, ~50 MB resident
Platforms	macOS 15+	Linux · Windows · macOS
Install	Build from paean-ai/deeptide	npm i -g deeptide (this package)
Lineage	100% authored by DeepSeek V4	Powered by open-source Zero CLI
Best for	macOS users who want a tuned native experience	Linux/Windows users, CI, SSH sessions, headless boxes

This repository is the community front door for both — docs, FAQ, issue tracking — and is the home of the npm deeptide package that ships the cross-platform CLI.

Install (CLI)

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.

# 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

Install (macOS native app)

The macOS native build is open source at paean-ai/deeptide (Swift). Build from source via:

git clone https://github.com/paean-ai/deeptide.git
cd deeptide && ./scripts/release.sh --install

Pre-built .app releases will be announced on Releases when ready.

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.

Built-in capabilities

DeepTide is an agentic coding assistant — the model plans, calls tools, observes results, and adapts. Out of the box:

• Multi-turn agentic loop — plan → tool → observe → adapt
• Streaming responses — see the model think and act in real time
• 30+ built-in tools — file I/O, shell, web, tasks, MCP, scheduling, sub-agents
• 25+ slash commands — /status, /cost, /diff, /init, /permission, /hooks, …
• Permission modes — default · accept-edits · plan · bypass
• Hooks engine — pre/post tool, user-prompt, session, compaction shell hooks
• Memory system — persistent project memory across sessions
• Sub-agents from markdown — define custom agents in your project
• Plan mode — design before you code, get approval before execution

The tool catalog, slash command set, hook event names, and model aliases are kept aligned with the macOS native DeepTide app via the tide-spec shared interface contract — your hooks and muscle memory port between the two.

Documentation

• tide-spec — shared interface contract: tool catalog, slash commands, CLI flags, hook env vars, model aliases.
• Zero CLI docs — comprehensive reference for the CLI engine.
• DeepTide native source — Swift codebase for the macOS app.

Reporting issues

Open an issue. The new- issue form will route you to the right template:

• CLI bug or feature — typically forwarded to a8e-ai/zero-cli where the CLI code lives, but feel free to start here if you're not sure.
• macOS native app — report here. Please redact any sensitive paths, file names, or model output before pasting logs.
• Documentation, install, or general questions — start here.
• Security vulnerabilities — use private vulnerability reporting, not public issues.

⚠️ Privacy reminder: crash logs and console output may contain project paths, file names, environment variable values, or model output. Review before pasting into a public issue. If a report genuinely needs sensitive data, contact the maintainers privately instead.

About this npm package

The deeptide npm package is an intentionally thin redirect to @paean-ai/zero-cli, which contains all CLI source code. We publish under both names so users can install whichever feels natural; both resolve to the same binary with the DeepTide brand surface. There is exactly one source of truth (a8e-ai/zero-cli) — no duplicated implementation.

License

MIT — see LICENSE and NOTICE.

DeepTide is an independent project and is not affiliated with, endorsed by, or sponsored by Anthropic, Inc. or DeepSeek (Hangzhou) AI Co., Ltd.

_{Built with 🐳 by a8e — for DeepSeek, on every platform.}