Get started in one command

Four installation methods: global, ephemeral, scripted, or fully offline.

install

Output for `npm install -g @3a2dev/ansi-tui`

$npm install -g @3a2dev/ansi-tui

$ansi-tui

✓Node.js 18+✓Any modern terminal✓Ansible CLI pre-installed

Requirements

✓

Node.js 18+

Any LTS or current release. CI coverage includes Node 20, 22, and 24.

✓

Modern terminal

iTerm2, Warp, Windows Terminal, tmux, Alacritty, or any terminal with color support.

✓

Ansible CLI tools

ansi-tui wraps what is already installed. Install ansible-core and relevant tools separately.

✗

Docker or containers

Not required. ansi-tui is a Node.js process, not a container.

not needed

✗

Root or admin permissions

Not required. It works in user space.

not needed

All data is stored locally using OS-standard paths. No cloud. No telemetry. No account required.

Base path

macOS

Base path

~/Library/Application Support/ansi-tui/

Linux

Base path

~/.local/share/ansi-tui/

ansi-tui/

├── sessions/ # {uuid}.json — one file per named workspace

├── active_session # pointer to current session ID

├── history/ # {sessionId}.jsonl — job records per session

└── logs/ # {timestamp}-{tool}.log — raw execution output

$ npm test # Full 297-test suite

$ npx tsc --noEmit # TypeScript strict check

$ npm run lint # ESLint

$ npm run verify # All of the above