Skip to content
ovidius72Public

About

NIRI/TMUX like gui app

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1,998 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

heca

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.

Status Platform License


What it is

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 heca again to come back to them.

What heca is has the longer version, including how it differs from tmux.

Requirements

  • 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.

Download

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.

Build from source

git clone https://github.com/ovidius72/heca.git
cd heca
cargo build --release

The 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-dev

Start developing

cargo 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 widgets

Before a pull request, run what CI runs on Linux, macOS and Windows:

cargo clippy --workspace --all-targets --all-features -- -D warnings
cargo test --workspace

Day 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.

First run

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.

Command line

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.

Documentation

All documentation is in docs/. Start here:

What is planned and in progress lives in the project planner (.planner/, loaded with /planner load).

License

heca is free and open source: anyone can use, copy, modify and share it. It is licensed under either of

at your option.

Acknowledgments

  • 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.

About

NIRI/TMUX like gui app

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages