Skip to content

Topside 0.1.0

Choose a tag to compare

@ducban ducban released this 17 Nov 15:04
· 12 commits to main since this release
069f574

The first release, for macOS 14 or later on Apple silicon.

curl -fsSL https://topside.ducban.com/install.sh | sh

An island on the Mac's notch for Claude Code, Codex CLI, pi and omp. It shows which session wants an answer, takes the answer, and jumps to the session's terminal.

What's in it

  • The pill. One dot per session: blue working, orange waiting for you, green done, grey idle. The agent's logo in pixels beside them takes the color of the most urgent one.
  • The list. Hover the pill. Each row has the session's name (or its folder), the agent, the terminal and its age, then the prompt, the file being edited and the last reply. "Hide" leaves out a folder, "Hide like this" leaves out sessions that start the same way, and both can be undone.
  • Cards. A permission request opens with the diff. ^Y allows, ^N denies, ^A always allows (Claude Code), and "Auto mode" hands the session to auto. A question gets its options as buttons and ^1…^9. A finished turn shows its last reply for 5 seconds.
  • Jump. ^J or a click brings the terminal forward: the pane in WezTerm, Orca and tmux, the tab in iTerm2 and Terminal.app, the app in Ghostty.
  • Four agents. Claude Code and Codex through their hooks, pi and omp through an extension file. Claude Code sessions that were already running show up within 5 seconds.
  • Plan usage in the header. Claude Code's 5-hour and 7-day limits through its status line, Codex's from its session file. For pi and omp, what the session has cost.
  • Ask before risky commands. pi and omp run tools without asking. Switch this on and the island asks first about rm -rf, sudo, a forced push, git reset --hard and curl | sh. Nobody answers in 25 seconds, and the command is blocked.
  • Settings. A reminder for requests nobody answered, sounds, open at login, nine themes in light and dark, and the text size.

The app is ad-hoc signed, so install it with the script. A zip downloaded in a browser is quarantined and Gatekeeper refuses it.

SHA-256 of Topside.zip: 948924864d9ee63e6ad0491764006d2cd0d7c443fcf5cc6734fdfe0f5f276a3e