Eon
Build for Eons.
Website: eonterm.com
Eon is the terminal for humans and agents to work together: a native Wayland
workspace for long-running work such as coding agents, builds, servers and
editors. Its terminals keep running after you close the window.
Run eon attach and every tab, pane and terminal is where you left it.
Demo
Why Eon
- Close the window, keep the work. Orbit runs each
terminal's process and state apart from the window. Closing Eon detaches;
eon attach returns to the same terminals, and eon stop ends them when you
choose.
- Made for coding agents. Each tab has an Agent popup (Alt+Shift+L) that
starts the first installed of Codex, Grok, OpenCode, Pi or Claude and keeps
its session while hidden. When you're signed in, Codex and Claude quota appear
in the top bar.
- A tab per project. Each tab starts in a directory you pick with Zoxide or
browse to in Yazi. New panes open there, and the tab's Git popup runs LazyGit
in it.
- One pinned tool set. Nushell, Helix, Yazi, LazyGit and Anima are pinned
together, so every install gets the same tools.
- One terminal emulator, natively drawn. Unlike tmux inside another
terminal, one emulator owns each terminal's state, and
Venus draws it with
wgpu on Vulkan.
Get started
You need x86_64 Linux on native Wayland, Git, and Nix with flakes enabled.
Install the latest release, 0.1.2:
nix profile add --refresh github:Yazelix/eon/v0.1.2
Run eon. After a short animation (most keys skip it), pick a directory: press
Enter for a Zoxide match or Tab to browse with Yazi. A terminal opens there.
| Shortcut | Action |
|---|
| Alt+/ | Show every shortcut |
| Alt+Shift+T | New tab |
| Alt+M | New pane in this column |
| Ctrl+Alt+M | New column side by side |
| Alt+H / Alt+L | Column or tab to the left or right |
| Alt+K / Alt+J | Previous or next pane |
| Alt+Shift+L | Agent popup |
| Alt+Shift+J | Git popup |
| Alt+Shift+Y | Files popup (Yazi) |
| Alt+Shift+M | Commands popup: search and run Eon commands |
| Alt+Shift+S | Workspaces: switch or create a workspace in this window |
Close the window whenever you like. To come back or end work:
eon attach # return to your terminals
eon generations # list running and older generations
eon stop GENERATION # end one generation's terminals
eon --help lists every command. eon versions reports the pinned component
graph.
An optional, third-party binary cache
can avoid local builds for the edge builds it holds; tags have no guaranteed
coverage.
Status and limits
Eon is in beta: commands, configuration and behavior may still change between
0.x releases, and 1.0.0 marks the end of beta. It installs only through Nix for
now. It was proved on COSMIC and private Sway before the move to one
repository. Here, installed checks so far run on a private headless Sway, plus
a brief COSMIC launch check; the full desktop proofs and the bounded Orca
reader qualification
await re-proof. Other compositors, non-systemd hosts and proprietary NVIDIA
drivers are unproved. Restarting the machine ends live terminals.
Mac: Orbit passes its native Apple Silicon tests in this repository, and
Venus renders, handles input, and reattaches to Orbit natively on a scale-1
display. Han ideographs render blank with stock macOS fonts, and flag and
skin-tone emoji don't compose. Retina scaling, Japanese input, accessibility,
application identity, transparency and Eon itself are not proved on Mac yet.
Eon has no Mac install path or ETA yet, and Intel Macs are out of scope.
We're looking for Apple Silicon testers: open an issue.
Report a problem.
Guides
Contributing
Contributors and coding agents start with AGENTS.md and
Development. Architecture and
contracts record component ownership, exact product
boundaries and proof. Pull requests from outside the Yazelix organization are
read as reference and reimplemented here, with the author credited as
co-author; see Outside Contributions.
