Installation

Quick install (CLI + TUI)

One line installs the latest TUI release, which has the allman CLI bundled inside it. Linux and macOS, x64 and arm64:

curl -fsSL https://raw.githubusercontent.com/tarkaai/allman-tui/main/install.sh | bash

Mac app

Allman for Mac is a native menu bar app over the same CLI and store. It embeds the allman binary, so it needs no separate install.

1. Download Allman-<version>-arm64.zip from the allman-mac releases page.
2. Unzip, move Allman.app to /Applications and launch it. It lives in the menu bar; click the icon for the inbox.
3. Builds are ad-hoc signed and not notarized, so on first launch right-click Allman.app → Open.
4. Sign in from Settings → Accounts → Add Account…, which runs allman login for you.

Requires macOS 26 (Tahoe) on Apple Silicon. See the Mac app overview for what it does.

Build from source

Requirements

• Bun (latest) — runtime and build tool
• macOS or Linux (Windows via WSL)

CLI

git clone git@github.com:tarkaai/allman-cli.git
cd allman-cli
bun install
bun run build          # produces dist/allman

Add dist/allman to your $PATH, or run directly with:

bun run dev -- <command> [options]

Playwright browsers

Playwright’s Chromium browser is required for allman login only:

allman install-browsers
# or: bunx playwright install chromium

TUI

git clone git@github.com:tarkaai/allman-tui.git
cd allman-tui
bun install
bun run dev

Or build a standalone binary (bundles the allman CLI inside):

ALLMAN_BIN=/path/to/dist/allman bun run build
# produces dist/allman-tui

Environment variables

Variable	Description
ALLMAN_STORE	Override default store path (default: ./.allman for CLI, $HOME/.allman for TUI)
ALLMAN_ACCOUNT	Default account slug (when multiple accounts exist)
ALLMAN_BIN	Absolute path to the allman binary (for the TUI and the Mac app)
ALLMAN_TUI_LISTEN	Set to 0 to disable the live event stream in the TUI
PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH	Use an existing Chromium binary for login