TIDE-STACK

One seat for many projects — threads, works, a board.
CLI + markdown; sessions run with Claude Code.

PARTS

  1. PROJECTS — any folder with code, adopted in place
  2. THREADS — lines of sessions inside a project, with real handoffs
  3. PLUGINS SYSTEM — a small core; removable parts switched per home
  4. UPDATES SYSTEM — gated self-update with rollback
  5. TIDE CLI — every gesture is a command; agents walk the same verbs
  6. THE BOARD — home and every project on one localhost page
  7. SYSTEM SKILLS AND HOOKS — land in Claude Code when the home unfolds
  8. THREAD STRUCTURE — state is plain markdown in .tide/, readable by hand

YOU CAN

  1. INSTALL — CLI tool, Claude skills and hooks, in one script
  2. UPDATE — one command, gated, with rollback
  3. FIX BUGS — the source is already yours; fix and reinstall in place
  4. REPORT — send the pain upstream in one command
  5. WORK IN THREADS — via CLI and the board: create, handoff, resume, close
  6. UNDERSTAND HOW TO USE IT — the first hour, step by step
  7. SEE HOW IT WORKS TOGETHER — one page, one picture

INSTALL

# clone and install — puts tide on your PATH
git clone https://github.com/tide-tools/tide && cd tide
./install.sh

# unfold a home — one folder you lead everything from
mkdir ~/tide-home && cd ~/tide-home
tide init --git
export TIDE_HOME=~/tide-home    # add to your shell profile

# adopt a project — any folder with code, old or new
cd ~/code/myapp
tide adopt --goal "a small web app — trying tide"

# open the board
tide board --open               # http://127.0.0.1:8765
tailscale serve --bg 8765       # the same board on your phone

# stuck? the route, in your terminal or your browser
tide quickstart
tide quickstart --open

# update · fix · report
tide self-update                # git pull + reinstall — gated, with rollback
./install.sh                    # fixed the source? reinstall in place
tide report "what happened"     # the pain goes upstream

Homebrew carries the binary only — skills, hooks and the board travel with the clone:

brew tap tide-tools/tide https://github.com/tide-tools/homebrew-tide
brew install tide-tools/tide/tide