Skip to content

Releases

Topside 0.2.1

Choose a tag to compare

@ducban ducban released this 19 Nov 11:27
5ddb101

A fix for 0.2.0's new styles. macOS 14 or later, Apple silicon.

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

Run the same line over 0.2.0; your settings stay.

Fixed

  • Markdown in Board and Kitchen. The agent's reply, under a picked session and on a finished turn's notice, showed its headings, lists, code blocks and tables as raw ##, -, fences and pipes. It's drawn as markdown now: on the board in the board's own colors, and on a ticket in ink, with code on a darker strip of paper.

SHA-256 of Topside.zip: 5b13d00b0e8179d1bed16727f39bed45ca0ee5fa6721f9da28dde7f83e6953b5

Topside for Arch Linux 0.1.1

Choose a tag to compare

@ducban ducban released this 20 Nov 01:31
32baef4

Topside for Arch Linux 0.1.1

The first public release. Topside started on the Mac's notch; this is the same island for a Linux bar. It shows which coding agent wants you, lets you answer it from the bar, and jumps to its terminal when you'd rather type.

sudo npm install -g topside-arch

It needs Node 26 or later, npm and Quickshell (sudo pacman -S nodejs npm quickshell). Only tried on Arch with Hyprland so far, hence the name. An AUR package is ready and goes up once the AUR takes new accounts again.

What you get

Four agents. Claude Code, Codex CLI, pi and omp. Claude Code and Codex report through their hooks; pi and omp through a small extension file Topside writes for them. A session you started before installing still shows up, marked "Not tracked yet" until its agent reloads.

Three bars.

  • SekaiPop gets a bar entry.
  • DankMaterialShell gets a bar widget with a settings page.
  • Anything else gets a Quickshell pill you can park in one of nine spots.

topside setup finds what's running and installs the right one.

Answers from the bar. A permission request arrives with its diff or its command. Allow, Deny, Always (Claude Code's own suggestion, like accepting edits for the rest of the session) or Auto mode. On SekaiPop and DMS, a card you opened from the bar takes keys: ⌃Y allows, ⌃N denies, ⌃A always allows (Claude Code), ⌃J jumps. A card that pops up by itself takes none, so your typing stays in the terminal. Claude's multiple-choice questions come as buttons, and ⌃1 to ⌃9 pick them. Answer in the terminal instead and the card goes away by itself.

Jump. A click or ⌃J finds the session's window through its process tree and focuses it with hyprctl. Then it picks the tab: WezTerm's pane, Orca's terminal, or tmux's window and pane.

Three styles on SekaiPop.

  • Board, the default, is a split-flap departure board that lowers from the bar.
  • Kitchen prints order tickets you stamp ALLOW or DENY, with a kitchen rail for the session list.
  • Classic is the cards.

DMS and the pill draw Classic for now.

Nine themes plus yours. Topside's own nine, each in light and dark, or follow the desktop. Drop a JSON file in ~/.config/topside/themes/ for your own; topside theme check says what's wrong with it. On SekaiPop, the default look borrows the shell's surfaces, corners and font.

The rest:

  • Plan usage in the header: the 5-hour and 7-day windows and when they reset. Codex's comes with its hooks; Claude Code's needs topside usage install, which wraps your status line and leaves it as it was.
  • What a pi or omp turn cost, in dollars and tokens.
  • A sound when a request arrives or a turn ends out of sight. Off by default.
  • A reminder when a request has waited 2 minutes.
  • Hide a folder or a kind of prompt from the list. claude -p runs never show.
  • An optional gate that asks before pi or omp run rm -rf, sudo, git push --force and the like. topside gate on; nobody answering in 25 seconds counts as Deny.

After installing

As your own user, not root:

mkdir -p ~/.config/systemd/user
cp "$(npm root -g)/topside-arch/contrib/systemd/topside.service" ~/.config/systemd/user/
systemctl --user enable --now topside   # the daemon
topside hooks install                   # Claude Code; add codex, pi or omp for the others
topside setup                           # the bar entry, or run `topside pill`

topside hooks install keeps your other hooks and backs the file up first. For Codex, run /hooks once and trust Topside's entries.

Known gaps

  • Jump needs Hyprland. On another compositor the list still works and the jump fails with a message.
  • The pill has no keyboard shortcuts, sounds, reminders or hiding yet.
  • Ghostty, Kitty and Alacritty get the window but not the tab.

Coming from via

Topside used to be Vibe Island on Arch, with the command via. The first topside command moves your database and pill config across, and via stays as an alias for now. The README's "Upgrading from via" section has the rest.

Bugs and ideas: https://github.com/ducban/topside/issues

Topside 0.2.0

Choose a tag to compare

@ducban ducban released this 19 Nov 11:18
009950a

Two new styles for the island, both borrowed from the Arch version, and sounds to go with them. macOS 14 or later, Apple silicon.

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

Already on 0.1.0? Run the same line. It swaps the new app in and keeps your settings.

Styles

Settings → Appearance → Style. Classic, the cards, stays the default.

  • Board. A split-flap departure board. A request drops the board out of the notch with a status word clacking into place (WAITING, QUESTION, SECURITY for pi and omp, DELAYED once reminded), answered on big keys. The list reads as departures. Click one and you get its prompt, the agent's last reply and Jump.
  • Kitchen. The notch is a ticket printer. A request feeds out as an order ticket (MAY I EDIT?, or RISKY COMMAND under hazard stripes) and you answer it with a rubber stamp. The stamp lands, the ticket tears off, and only then does the answer go out. The list is a kitchen rail: the plan limits chalked on a menu board, and five tickets on magnets, waiting ones first. The rest go on a spike you click to page through.
  • Pinned. In both styles, a click on the pill pins the list. It stays when the pointer leaves, the screen dims behind it, and esc or a click on the dimmed screen puts it away. The gear pins settings the same way.

Sound

  • Style sounds. With Sounds on, the board chimes (rising for a request, falling when a turn ends) and its flaps clack. The kitchen's printer chatters, a bell rings when a turn ends, and the stamps, tears and magnets sound the part. The app makes them in code and ships no audio files. "Style sounds" in Settings turns them off and goes back to the system sounds.
  • The speaker. A speaker icon left of the gear, in every style, turns sound on and off without opening Settings.

The app is still ad-hoc signed, so install with the script; a zip downloaded in a browser is quarantined.

SHA-256 of Topside.zip: 1ef495ca3102bbff2801a823db73e614f6f13dd24c27e6c4b78225f68b862bdb

Topside 0.1.0

Choose a tag to compare

@ducban ducban released this 17 Nov 15:04
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