Skip to content
 
 

Repository files navigation

Séance-fork

Séance logo

A scrolling terminal multiplexer that tracks your AI coding agents.

Séance-fork is an experimental fork of the Séance scrolling terminal multiplexer that tracks your AI coding agents, with additional features and enhancements:


Séance demo

Why Séance?

Séance is a GTK4 terminal multiplexer for Linux. It auto-detects Claude Code, Codex, Pi, OpenCode, Kilo Code, MiMo Code and Vibe sessions running inside it and tracks their status (working, waiting for permission, idle) live in the sidebar. Permission requests and task completions are surfaced as desktop notifications with unread tracking. Zero configuration, no dotfile edits: open an agent in a pane and it is tracked.

Linux-native, not Electron

GTK4 and libadwaita, so it integrates with the rest of GNOME and with tiling WM setups. X11 and Wayland. Blur and transparency on both. GPU-accelerated terminal rendering via libghostty (Ghostty used as a library).

Scrolling layout

Panes are arranged in a horizontal strip that you scroll through, borrowing the layout model from niri. Fits long, linear agent sessions better than a tiling grid, and lines up naturally with scrolling tiling WMs.

Agent-agnostic

Claude Code, Codex, Pi, OpenCode, Kilo CLI, MiMo Code, and Vibe are auto-tracked out of the box. Adding support for another agent is a hook config PR rather than a rewrite. Agents that do not speak hooks still get all the plain multiplexer features.

Scriptable

Every action is available through seance ctl, which talks to the running instance over a Unix domain socket. Scripts and AI agents can create workspaces, open panes, send input, read terminal output, and query the full session hierarchy. All commands support JSON output.

A bundled skill file provides AI agents with a complete reference for the seance ctl API, so they can use the multiplexer on their own.

And also

Workspaces, session persistence across restarts, tabs within columns, a command palette, focus-follows-mouse, and no telemetry.

Installation

AppImage

Download the latest seance-*-x86_64.AppImage from GitHub Releases, make it executable, and run it:

chmod +x seance-*-x86_64.AppImage
./seance-*-x86_64.AppImage

Requires libfuse2 on the host. Uses the host's libGL/libEGL, so Mesa or proprietary GPU drivers must be installed.

To use seance ctl from your shell, move the AppImage onto your PATH:

mv seance-*-x86_64.AppImage ~/.local/bin/seance

Building from source

Requires Zig 0.15.2+, GTK4, libadwaita, OpenGL 4.3+, and Linux (X11 or Wayland).

Install build dependencies (Ubuntu/Debian):

sudo apt install pkg-config libgtk-4-dev libadwaita-1-dev libnotify-dev libcanberra-dev inotify-tools

Build:

git clone --recursive https://github.com/scross01/seance-fork.git
cd seance
zig build

The binary is at zig-out/bin/seance.

If the ghostty dependency is missing:

git submodule update --init --recursive

Agent Integrations

Claude Code, Codex, Pi, OpenCode, and Kilo Code are all tracked automatically — no setup required.

  • Claude Code, Codex, Pi: Séance installs wrapper scripts that intercept calls to these agents and inject lifecycle hooks transparently.
  • OpenCode: On first launch, Séance auto-installs a plugin to ~/.config/opencode/plugins/ if the OpenCode config directory exists.
  • Kilo Code: On first launch, Séance auto-installs a plugin to ~/.config/kilo/plugins/ if the Kilo config directory exists.
  • Poolside, Codebuff, Freebuff: Requires inotify-tools for real-time agent status monitoring.

To disable OpenCode integration: Settings → Terminal → OpenCode Integration, or set opencode-hooks = false in ~/.config/seance/config.toml.

To disable Kilo Code integration: Settings → Terminal → Kilo Code Integration, or set kilo-hooks = false in ~/.config/seance/config.toml.

Contributing

Bug reports, feature requests, and pull requests are welcome. See CONTRIBUTING.md for how to file issues, build locally, and add support for new agents. Questions and show-and-tell go in Discussions. Security issues should be reported privately, see SECURITY.md.

License

MIT

Acknowledgements