GET SET UP

INSTALL

Download the .dmg from the download page, open it, and drag Kibann Terminal to Applications. Builds are for Macs with Apple silicon, signed and notarized.

It updates itself: it checks when it starts and then hourly, downloads in the background, and offers Restart to update. Your shells keep running through the restart.

TEACH YOUR AGENTS

Every shell in Kibann can run kibann, a command line for opening panes and tabs, typing into them, reading them and waiting on them. Run this once, from any Kibann pane, and your agents learn it:

It writes ~/.claude/skills/kibann, which Claude Code and OpenCode read, and ~/.agents/skills/kibann for Codex when Codex is installed. Pass --claude, --codex or --opencode to set up just one.

Then ask your agent to work in a pane beside you. Under the hood it runs things like:

• Environment: each shell gets KIBANN_PANE, KIBANN_SOCKET and KIBANN_BIN, and kibann is on its PATH.
• Output: results are JSON; errors are JSON on stderr with exit code 1.
• Help: kibann help lists every command.
• Security: the socket is private to your user, so nothing else on the machine can type into your panes.

AGENT STATUS

Panes running Claude Code, Codex or OpenCode show what the agent is doing with a dot in their corner:

Tabs show their most urgent dot, the Dock icon counts agents waiting for you, and a notification tells you when an agent you aren't looking at waits or finishes. Click it to go to the pane. Turn notifications off with agent-notifications = false.

Scripts can join in: kibann pane report --agent NAME --state working|idle|blocked, and kibann pane wait P --until done,blocked waits for an agent.

SHELLS & QUITTING

Your shells run in a background process that owns the tabs and splits, so closing the app doesn't end them:

• Close the window or Cmd+Q: hides Kibann to the menu-bar icon. Shells keep running and agents can still notify you; the icon shows a dot while one waits.
• Close a pane: ends its shell.
• Quit Kibann Terminal…: in the app menu or the menu-bar icon asks first, then ends every shell.
• After a reboot: tabs and splits come back at the same sizes, each a fresh shell in the directory it was in.

Prefer a classic quit? menu-bar-icon = false removes the icon, and closing the window quits the app (the shells still keep running). restore-layout = false starts fresh after a reboot.

SETTINGS & CONFIG

Cmd+, opens Settings: notifications, the menu-bar icon, the sidebar's hover preview, theme, font, every shortcut, and updates.

Settings writes one plain-text file, ~/.config/kibann/config, in Ghostty's syntax. Edit it by hand if you prefer; changes apply when you save, and Settings keeps your comments and order.

THEMES & FONTS

View → Theme…, or the half-circle at the bottom of the sidebar, opens a live picker of about 900 themes (the iTerm2-Color-Schemes collection, with Ghostty's names). The whole window follows the theme, not just the terminal.

Your own themes go in ~/.config/kibann/themes/, one Ghostty-format file per theme. Fonts fall back to the bundled JetBrains Mono, then the system's fonts for CJK and emoji.

SHORTCUTS

Ghostty's defaults. Cmd+/ shows them all in the app. On Linux, use Ctrl or Ctrl+Shift in place of Cmd.

Change any of them with keybind lines, in Ghostty's syntax and action names, so most of a Ghostty config's keybinds work as they are:

LINUX

There are no Linux downloads yet, but it builds from source. You need Rust, Node, Zig 0.17, and the WebKitGTK and GTK development packages. On Debian or Ubuntu:

Windows isn't supported yet.