Skip to content

v1.0.0

Choose a tag to compare

@zkzofn zkzofn released this 21 Aug 05:47
· 14 commits to main since this release

pier itself is now the way you start a session — the shell wrapper people used to hand-roll is built in.

The entry point

  • pier — outside tmux it opens the picker and attaches to whatever you pick; inside tmux it runs claude in the current pane. pier -r, pier --continue, … pass straight through to claude (pier keeps only -v / -h), and an unknown bare word prints usage instead of starting a session
  • First run is a short wizard: it offers to wire tmux and the Claude Code hooks (same as pier setup), then to write a shell alias — cl by default — as a marked block in your login shell's rc file (zsh / bash / fish). pier alias <name> changes it later
  • Update check — once a day a pier start compares your version against the Homebrew tap and offers brew upgrade (source installs get a one-line notice). PIER_NO_UPDATE_CHECK=1 turns it off. After an upgrade the first run refreshes pier's ~/.tmux.conf block, keeping whatever binary path it already points at

Leaving a session is clean

  • set -g detach-on-destroy off plus a pane-exited hook (pier reap): a session ends the moment only its sidebar is left, and your client moves to the most recent session instead of being dropped out of tmux — plain exit now behaves like prefix+x
  • When the last session closes, the standalone attach erases tmux's [exited] line, so the terminal looks as it did before pier ran

Picker

  • Running sessions are listed above the directories, with the sidebar's own status icons — Enter on one jumps back into it. Typing filters both groups; the cursor starts on the first running session
  • The plain-shell option (^S) is called a terminal session everywhere

Also in this release (never published separately)

  • v0.11.0 — explicit resume from the picker: a ↻ resume button per casualty directory, an ↻ restore all row, ^T for the telegram channel
  • v0.10.0 — crash and OS-shutdown detection that makes those offers possible