@3a2dev/ansi-tui v0.1.0

Ansible Terminal User Interface

Every ansible-* command. One guided interface. Zero context switching.

Select an action, fill a form, preview the exact command, then execute with live output streaming, session context, job history, and 8 themes included.

$
ansi-tui โ€” Ansible Terminal UI
ansi-tui demonstration showing tool navigation, form filling, command preview, and live execution
npm package
8 themes
11 interactive tools
60+ supported actions
8 color themes
npm monthly downloads
Node 18+ runtime
MIT license

Why ansi-tui?

Everything you need to run Ansible confidently without leaving your terminal or opening a flag reference.

โ–ถ

11 interactive tools

Full coverage of ansible-playbook, ansible-galaxy, ansible-vault, ansible-inventory, ansible-doc, ansible-config, ansible-lint, ansible-builder, ansible-creator, ansible-test, and ansible-console.

โšก

4-phase guided workflow

Select action, fill the form, preview the command, then execute. The same workflow every time, on every tool.

๐Ÿ’พ

Session persistence

Named workspaces with inventory, vault, proxy, tags, environment variables, and notes pre-filled per project or customer.

๐Ÿ“บ

Live execution output

Streaming ANSI-aware output with pause and resume, elapsed time, scroll controls, and a full output log recorded per job.

๐ŸŽจ

8 color themes

Cyan, Blue, White, Gray, Yellow, Violet, Red, and Neon. Press t to cycle through them live in the terminal.

๐Ÿข

Enterprise-ready

Proxy-aware, offline-installable, no Docker required, and designed to run cleanly on jump hosts and shared systems.

๐Ÿงช

297 tests

Unit, component, screen, hook, and integration coverage with CI running on Node.js 20, 22, and 24.

โŒจ

Keyboard-first

Every action is reachable without a mouse, including navigation, forms, output scrolling, and the built-in path picker.

๐Ÿ”’

Local-first and safe

Stored locally with masked password fields, explicit command preview, and array-mode execution to avoid shell-quoting risks.

One workflow for every Ansible command

Every tool follows the same four-phase workflow. No docs needed. No flag memorisation.

01
โŠž

Action Select

Pick the Ansible tool and action you want to run from a guided sidebar.

Grouped sidebar by tool, then expand and choose the action

02
โ‰ก

Parameter Form

Fill the form with path browsing, session defaults, and validation before execution.

Auto-filled from active session and Ctrl+F opens the picker

03
โ–ถ

Command Preview

Inspect the exact argv and flags before anything runs so there are no surprises.

Exact command preview with validation state before run

04
โšก

Execute

Stream live output with ANSI rendering, scrolling, pause and resume, and automatic job logging.

Real execution, live output, and durable history records

โœ“ Forms auto-fill from the active session
โœ“ Ctrl+F opens a built-in file or directory browser on path fields
โœ“ Command preview shows exact flags and argv before run
โœ“ Validation blocks execution when required inputs are missing
โœ“ Esc returns to the previous step from any phase
โœ“ Every execution is recorded in job history automatically

Every ansible-* command.
All in one place.

11 first-class interactive tools ยท 60+ supported actions

Tool Count
โ–ถ ansible-playbook
7
โ—ˆ ansible-galaxy
17
โ—† ansible-vault
7
โŠž ansible-inventory
3
โ‰ก ansible-doc
4
โš™ ansible-config
5
โš‘ ansible-lint
4
โฌก ansible-builder
3
โŠ• ansible-creator
5
โ—‰ ansible-test
8
โŒ˜ ansible-console
1

All tools follow the same four-phase workflow: select, form, preview, execute.

Your terminal. Your color.

8 built-in themes. Press t to cycle them live.

ansi-tui theme cycling
ansi-tui cycling through multiple built-in terminal themes

Live Theme Preview

Cycle the whole workstation without leaving the keyboard

Theme changes apply across the shell, panels, health matrix, footer, and live execution views. The result stays terminal-native instead of feeling like a web skin pasted on top.

press t 8 built-in palettes live switch

Cyan

Electric teal, professional dark

Blue

Deep blue, corporate precision

White

Monochrome light, clean terminal

Gray

Monochrome dark, minimal brutalist

Yellow

Amber and gold, vintage CRT warmth

Violet

Deep purple, refined dark

Red

Warm command-center with amber highlights

Neon

Cyberpunk green-on-black

Press t in any screen to cycle themes live.

Designed for keyboard. Always.

ansi-tui is built around a real keyboard flow: highlighted keys show the shortcuts you actually use while navigating, editing forms, and running commands.

Visual Keyboard

Keyboard navigation layout.

Global

q Quit
s Sessions screen
t Cycle theme
โ†‘ / โ†“ Navigate sidebar
โ†’ Expand tool actions
Esc Back or collapse
Enter Select or confirm

Form

โ†‘ / โ†“ Next or previous field
Ctrl+F Open file or directory picker
Tab Next field
Esc Cancel and return to action list

Execution

โ†‘ / โ†“ Scroll output
Space Pause or resume auto-scroll
Esc Return to form
For a full keyboard layout visit the desktop version.

Get started in one command

Global install, no-install execution, install script, or fully offline deployment for air-gapped environments.

$npm install -g @3a2dev/ansi-tui
$ansi-tui
โœ“Node.js 18+โœ“Any modern terminalโœ“Ansible CLI pre-installed

Frequently asked questions

No. ansi-tui is a Node.js terminal app. The only requirements are Node.js 18 or newer and the Ansible CLI tools you already have installed.

Stop memorising flags.
Start automating.

ansi-tui is free, open source, and ready to work with the Ansible tools you already have installed.