Heca takes its name from the Hecatoncheires — hundred‑handed giants of myth — because it lets you juggle terminals, editors, and tools in a single GPU‑accelerated window. Think prefix keys, smooth animations, and zero ambrosia required.
A GPU-native terminal workspace compositor for developers. Inspired by NIRI's scrollable-tiling model, powered by wgpu and cosmic-text.
Think tmux meets NIRI meets Neovide — all panes render in a single GPU-accelerated window with smooth animations, sharp fonts, and zero window seams.
heca is a workspace compositor — not a traditional terminal emulator or window manager. It hosts terminals (and, later, other tools) inside one native window, laid out the way NIRI lays out windows.
- Scrolling columns. Panes sit in horizontal columns that scroll smoothly; each column keeps its own width, and opening a pane never resizes the others.
- Vertical stacks and workspaces. Panes stack inside a column; workspaces stack vertically and switch with an animation.
- Floating panes. Any pane can leave the layout and float.
- Prefix keys. Every command is
Ctrl+B, then a key, like tmux, so nothing clashes with the program in the pane. Every key can be changed. - GPU-native chrome. Tab bar, sidebars, status bar and pane borders are drawn in the same GPU pass as the terminals.
- Sessions. heca runs as a background server. Close the window and your panes keep running; run
hecaagain to come back to them.
What heca is has the longer version, including how it differs from tmux.
- Rust 1.100 or newer. The repository pins the exact version in
rust-toolchain.toml, so rustup installs it for you. - GPU with Vulkan (Linux), Metal (macOS), or DX12 (Windows) support.
- OS: Linux, macOS, or Windows.
Every release is on the GitHub Releases page: an
installer and an archive for each system — .dmg on macOS (Apple Silicon and Intel), .deb and
.AppImage on Linux, .msi on Windows. The builds are not signed yet; the release page says how to
open them. Or build heca from source, as below.
git clone https://github.com/ovidius72/heca.git
cd heca
cargo build --releaseThe program is target/release/heca (target\release\heca.exe on Windows). Run it from there,
or copy it somewhere on your PATH.
On Linux, install the system packages first (Debian/Ubuntu names):
sudo apt-get install pkg-config libasound2-devcargo run -p heca # run heca from the source tree
cargo run -p heca -- --standalone # a session of its own that ends with the window,
# without attaching to a heca already running
cargo run -p heca --example extend_heca # heca with the extension example
cargo run -p heca-renderer --example showcase # the gallery of UI widgetsBefore a pull request, run what CI runs on Linux, macOS and Windows:
cargo clippy --workspace --all-targets --all-features -- -D warnings
cargo test --workspaceDay to day, ./scripts/lint-changed.sh (and ./scripts/lint-changed.sh test) checks only the
crates you changed, which is much faster.
Developing heca has the details. Contributors, human or agent, read
AGENTS.md first: it holds the project's rules.
On first launch, heca creates a default config at:
- Linux/macOS:
~/.config/heca/config.toml - Windows:
%APPDATA%\heca\config.toml
The window opens with a single pane. All WM commands use a prefix key (Ctrl+B by default), like tmux:
Ctrl+B → h Focus left column
Ctrl+B → l Focus right column
Ctrl+B → Enter New column (horizontal split)
Ctrl+B → v New pane in column (vertical split)
Ctrl+B → x Close active pane
Ctrl+B → f Toggle floating
Close the window and heca keeps running in the background; run heca again to reattach.
Every command answers before the window opens, so a script can ask heca without a display.
heca --help always prints the complete, current list.
| Command | What it does | Documented in |
|---|---|---|
heca |
Open a window on the running server (starting it if needed). | Sessions |
heca --standalone |
Server and window in one process; the session ends with the window. | Sessions |
heca --sessions |
List the server's sessions. | Sessions |
heca --attach <name> |
Open a window on a named session. | Sessions |
heca --new [path] [--name <name>] |
Create a session in a folder and open its window. | Sessions |
heca --kill <name> |
Terminate a session (asks first); it can be restarted later. | Sessions |
heca --server [socket] |
Run the session server without a window. | Server and clients |
heca --kill-server |
Stop the server, and every pane with it. | Sessions |
heca --show-keys (-k) |
Every key binding, the key it resolves to and its layer. | Keyboard commands |
heca --list-actions (-a) |
Every action heca knows — what a key, a menu or a script can run. | Configuration |
heca --describe-action <name> (-d) |
One action in full, with its arguments. | Configuration |
heca --show-config |
Every setting your files set, and the file each came from. | Configuration |
heca --trust [folder] / --untrust [folder] |
Let a project's .heca/config.toml apply, or stop it. |
Configuration |
heca install / update / uninstall / inspect integration <program>, heca list integrations |
Manage a program's status-reporting integration (Claude, Codex, …). | Configuration |
heca rpc <action> [name=value …] |
Run an action on the running server from a script. | Server and clients |
The commands that print add --json (-j) for scripts.
All documentation is in docs/. Start here:
- Keyboard commands — every default key.
- Configuration —
config.toml: theme, fonts, appearance, notifications. - Keybindings — rebind a key, add your own, write a mode.
- Sessions — detach, reattach, follow another window.
- Architecture — the stack and how the crates fit together.
- Developing heca — running, testing and the examples.
- Building on heca and writing a plugin.
What is planned and in progress lives in the project planner (.planner/, loaded with /planner load).
heca is free and open source: anyone can use, copy, modify and share it. It is licensed under either of
- the MIT License, or
- the Apache License, Version 2.0,
at your option.
- NIRI by Ivan Molodetskikh — The scrollable-tiling compositor that inspired heca's layout engine.
- cosmic-text by System76 — GPU text rendering with excellent font shaping.
- wgpu — Safe, portable GPU API for Rust.