Back to directory

deeptide

Maintenance: Active

paean-ai/deeptide

Built by DeepSeek, for DeepSeek — a Swift-native macOS coding agent

View on GitHubHomepage
$ curl -fsSL https://deeptide.sh/install.sh | sh

1,098

stars

138

forks

Rust

Language

MIT

License

2026-05-05

Created

2026-08-22

Last push

MIT-licensed, DeepSeek-first agentic coding agent (native macOS app, Bun/npm CLI, or Rust CLI + desktop GUI) with 30+ tools; a standalone DeepSeek-ecosystem agent, not a DeepSeek Harness (dsh) plugin.

DSH integration

Ecosystem-related

Author-claimed

Safety audit

Unaudited

Last verified

2026-08-21

License

MIT

01What can it help you accomplish?

  • Run agentic coding tasks (edit files, run shell, research) from a terminal against the DeepSeek API

    Streaming multi-turn plan→tool→observe→adapt sessions with 30+ built-in tools (file I/O, shell, web, MCP, scheduling, sub-agents) and 25+ slash commands

    Developers on macOS / Linux / Windows who want a DeepSeek-first coding agent in the terminal

  • Get a native macOS / desktop GUI coding agent that shares config, sessions and tools with the CLI

    A Swift-native macOS app and a single-binary Rust egui desktop GUI reading the same settings.json, on-disk session store and full tool set as the CLI

    macOS users and anyone who prefers a native GUI over the terminal for a DeepSeek coding agent

02How to install into DeepSeek Harness

Prerequisites

  • macOS 15+ for the native Swift app (`DeepTide.app`)
  • Linux / Windows: Bun installed and on PATH (required by the `deeptide` CLI runtime, matching Zero CLI)
  • A DeepSeek API key, Paean OAuth sign-in, or a BYOK Anthropic-compatible endpoint to use the agent

Installation steps

  1. 01

    macOS (recommended): `curl -fsSL https://deeptide.sh/install.sh | sh` — installs the signed native build plus the `deeptide` and `tide` commands

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

  2. 02

    Linux / Windows: `bun add -g deeptide` (or `npm install -g deeptide` / `pnpm add -g deeptide`) — installs the `deeptide` and `tide` aliases

    $ npm install -g deeptide

  3. 03

    Optional Rust build: `npm install -g deeptide-rs` — installs `deeptide-rs`; `deeptide-rs --gui` launches the native desktop GUI

    $ npm install -g deeptide-rs

  4. 04

    Sign in: `tide auth login` (Paean OAuth) or `tide login` (save a DeepSeek API key directly), then launch with `tide`

Verify the integration

  • `tide doctor` — diagnose install + network

03DSH integration and capability boundaries

DSH integrationEcosystem-related

Standalone DeepSeek-first agentic coding agent (cross-platform CLI, native macOS app, and Rust CLI + desktop GUI). It calls the DeepSeek API directly rather than installing into or running under DeepSeek Harness (dsh) — an ecosystem-level relation, not a dsh plugin.

  • Multi-turn agentic loop with 30+ tools

    a codebase plus a task in the REPL or a `-p` one-shot promptstreaming plan→tool→observe→adapt sessions over file I/O, shell, web, tasks, MCP, scheduling and sub-agents

    writes/edits filesexecutes shell commandsmakes network requests (WebFetch)
  • Slash commands, permission modes & hooks

    25+ built-in slash commands plus markdown-defined custom commands under `.deeptide/commands/`/status, /cost, /diff, /init, /permission, /hooks etc. with default · accept-edits · plan · bypass modes and pre/post tool + session shell hooks

    hooks execute shell commandsplan mode gates execution behind approval
  • Persistent memory & sub-agents

    project context and markdown-defined agents / commandspersistent project memory across sessions; custom sub-agents and custom slash commands defined in markdown

    writes project memory and `.deeptide/` configuration
  • DeepSeek web research (`/deep-seek`)

    a `/deep-seek <question>` queryproposed official/canonical URLs verified via WebFetch and labeled [verified] / [known] / [unverified]

    performs network requests (WebFetch)optional BRAVE_SEARCH_API_KEY / SERPER_API_KEY improve source discovery

04Who is it for? When not to use it?

Good for

  • Developers on macOS / Linux / Windows who want a DeepSeek-first coding agent in the terminal
  • macOS users and anyone who prefers a native GUI over the terminal for a DeepSeek coding agent

Not for

  • The cross-platform `deeptide` CLI (the Bun / Zero-CLI build) requires Bun installed and on PATH at runtime on Linux and Windows; it is not the Swift-native macOS build.

05Compatibility, maintenance and safety notes

  • The cross-platform `deeptide` CLI (the Bun / Zero-CLI build) requires Bun installed and on PATH at runtime on Linux and Windows; it is not the Swift-native macOS build.
  • The agent needs a credential and network access — a DeepSeek API key by default, or a BYOK Anthropic-compatible endpoint; without a credential the GUI only opens in a local-echo mode.
  • The native Swift app (`DeepTide.app`) targets macOS 15+ only; Linux and Windows are served by the CLIs / Rust build rather than the native app.
2026-05-052026-07-08Not specified by the author

MIT · actively maintained (last push 2026-07-08)

06Frequently asked questions

Is DeepTide a plugin for DeepSeek Harness (dsh)?

No — DeepTide is a standalone agentic coding agent built for DeepSeek, not a plugin that installs into DeepSeek Harness. It talks to the DeepSeek API directly (or any Anthropic-compatible endpoint via BYOK) from its own CLI, native macOS app, or desktop GUI.

How do I install DeepTide?

On macOS run `curl -fsSL https://deeptide.sh/install.sh | sh` for the native build; on Linux/Windows run `bun add -g deeptide` (Bun required) or `npm install -g deeptide-rs` for the Rust CLI + desktop GUI. Then sign in with `tide auth login` / `tide login` and check with `tide doctor`.

Which model provider and API key does it use?

It uses the DeepSeek API by default (`DEEPSEEK_API_KEY`), and can drive any Anthropic-protocol-compatible endpoint via BYOK — Zhipu GLM, Volcengine, Paean, Qwen, Moonshot, self-hosted gateways — with `--base-url` and `--api-key`.

What can the agent actually do?

It runs a multi-turn plan→tool→observe→adapt loop with 30+ built-in tools (file I/O, shell, web, MCP, scheduling, sub-agents), 25+ slash commands, permission modes, hooks, persistent project memory, and `/deep-seek` web research that verifies URLs with WebFetch.

Does the desktop GUI share the CLI's config?

Yes — `deeptide-rs --gui` reads the same `~/.config/tide/settings.json` (and project `.deeptide/settings.json`), the same on-disk session store, and the full tool set, so CLI and GUI sessions/config are fully shared.

08Data and sources

  • Author-claimedgithub.com4604b1757131…

    An AI coding agent that flows through your codebase like a tide.

  • Author-claimedgithub.com4604b1757131…

    DeepTide CLI talks to the **DeepSeek API** by default (matching the DeepTide native app), and can also drive any Anthrop…

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-21. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.