Installation

Requirements

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

Install from source

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]

Install Playwright browsers

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

allman install-browsers
# or: bunx playwright install chromium

Install the 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 TUI)
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