Skip to content

Repository files navigation

Liu Terminal

Liu Terminal

One terminal for every AI agent.
Liu sits between you and a variety of coding agents and makes ten parallel threads feel like one place.
Written in C — no Electron, JavaScript, or frameworks.

Download · Releases · Docs · GitHub

Languages: English · Türkçe · 简体中文 · 한국어 · Español · Deutsch · Italiano · Français · 日本語 · العربية


Features

Agent History

Press ⌘K, type agent history, and browse every installed AI CLI — Claude Code, Codex, Copilot, OpenCode, Qwen, Cline, Antigravity, Grok, and more. Resume a session natively or scroll the transcript without launching the agent.

AI Create Theme

Describe a look; a local agent emits JSON; Liu applies it live. Saved into ~/.config/Liu/themes/ alongside the built-ins.

Markdown Reader & Editor

The file browser opens READMEs, designs, and agent notes — styled Markdown preview or raw edit in-window. Images, code blocks, and links render in read mode.

Graph View

A knowledge graph of every Markdown file in a folder — nodes are files, edges are [[wikilinks]] and embeds. Force-directed layout; hover to light up neighbours, drag to pin, click to open.

Built-in notification system

liu-notify speaks only when an agent truly needs you — a voice alert, a desktop banner, or a custom sound. A standalone background service that keeps running even when Liu is closed.

Token Saving

Hit Ctrl+⌘ twice in your prompt — a local Metal-accelerated LLM (or chosen agent) translates non-English to English before the request leaves your machine. Context window shrinks; API bills drop.

Metal & OpenGL renderer

Metal on macOS, with an OpenGL 3.3 fallback renderer for development builds. Multi-pass pipeline — batched backgrounds, one instanced draw per glyph batch, on-demand atlasing.

Built-in SSH

Full SSH client behind one Session: live file upload and download, remote file browser, port forwarding (-L / -D), password / key / agent auth, known-hosts TOFU, Mosh reconnection, and recent-session history.

Command Palette

A single ⌘K fuzzy-searches every command, setting, host, snippet, theme, and Agent History entry — no menu hunting.

Splits + Tabs

Up to 32 tabs, each with up to 8 panes in any H/V split tree. Pane drag-and-drop. ⌘⇧I broadcasts input to every active pane simultaneously.

In-App Browser

Embedded WKWebView beside your terminal — open it from ⌘K as a tab or split it right/left/above/below a pane (up to 4 browser tabs, recents remembered). Element Pick grabs any node on a live page — CSS selector, tag, text, size, and full HTML — as a context chip dropped straight into your agent's prompt. Connection errors offer one-click Ask Agent.

Site Manager

Save local project folders as sites: start and stop dev servers from one panel, watch live logs and HMR updates, and open the Local URL in the browser — without leaving the terminal.

File Browser

Sidebar local + SFTP browser with one-click open. Drag-to-Finder transfers files in the background. 32 MiB LRU image cache.

Tab Sleep

Tabs idle for N minutes auto-suspend — CPU and RAM drop to near zero. Click to instantly resume exactly where you left off, scrollback intact.


Supported platforms

Platform Architecture Format
macOS Apple Silicon (arm64) .dmg
macOS Intel (x86_64) .dmg

macOS is the primary and only supported target.

Package managers: Homebrew — see liu.software for install commands.

Our Goal

  • Linux support — ARM64 and x86_64 builds (.tar.gz), apt (PPA), dnf (COPR), and AUR packages. Linux is planned but not currently supported.

Build from source

Dependencies

  • macOS — brew install libssh2
  • SQLite3, stb_truetype, stb_image, and cJSON are vendored under third_party/
git clone https://github.com/calculusteam/liu.git && cd liu

./build.sh              # interactive build TUI (macOS)
./build.sh --yes        # non-interactive recommended build
./build.sh --package    # build + release artifact

# Or CMake directly:
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j$(sysctl -n hw.ncpu)
./build/Liu

A single build also produces liu-notify (notification daemon) and liu-history (agent-history CLI).

tic -x liu.terminfo     # install custom terminfo entry

Release safety

VERSION is the release source of truth. A change to it on main starts the release build, but the publish job targets the GitHub production environment. Before the first release, configure Settings → Environments → production with at least one Required reviewer (and disable self-review if a second pair of eyes is required). Until that repository setting exists, a workflow environment alone does not create an approval prompt.

The publish job verifies the signed update feed and manifest before it uploads to the R2-backed liu.software downloads, then mirrors the same assets to the calculusteam/liu GitHub Release.


MIT

About

Terminal for AI-assisted development. Written in C11 with Assembly. Features Metal/OpenGL rendering, built-in SSH/SFTP, agent session history, multi-tab splits, and AI-powered translation. No Electron, no frameworks.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages