ansible-navigator

What it is and what it does

ansible-navigator is a curses-based terminal UI that wraps Ansible, letting you run playbooks, browse collections, inspect inventory, and read documentation interactively. Instead of running separate ansible commands and parsing their output, you navigate through a structured interface where you can zoom in on data, filter results, and explore relationships between Ansible components in real time.

The tool runs in two modes: interactive (the default, with a full TUI) and stdout (plain terminal output). By default it uses a container runtime to execute Ansible in an execution environment, which keeps your system clean and reproducible; you can disable this with a flag to run Ansible directly on your machine. It depends on ansible-runner, ansible-builder, ansible-lint, and standard libraries like jinja2, jsonschema, and pyyaml.

Use it for:

• Interactively debug and explore a playbook's execution, stepping through tasks and inspecting variables in real time.
• Browse available Ansible collections and their documentation without switching to a web browser or separate docs tool.
• Explore and validate an inventory file visually, filtering hosts and groups to understand your infrastructure layout.
• Review Ansible configuration and documentation inline while working on automation tasks.
• Run playbooks with integrated output exploration, allowing you to drill into task results without re-running or post-processing.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

ansible-navigator is a text-based user interface (TUI) for Ansible that lets you interactively explore playbooks, collections, inventory, and configuration without leaving the terminal.

Yes. ansible-navigator is actively maintained, has low install friction, carries no known vulnerabilities, and offers genuine value if you spend time in the terminal with Ansible. The Apache 2.0 license is permissive. The main gotcha is the default container runtime requirement—confirm your environment has podman or docker, or plan to use local execution mode.

Install

ansible-navigator on PyPI

pip install ansible-navigator

uv add ansible-navigator

poetry add ansible-navigator

Installing ansible-navigator

Before you install

Low install friction: pure Python wheel with 9 runtime dependencies. Actively maintained with a release 2 days ago and 544 repository stars. Requires Python 3.10 or later.

License in practice

Released under Apache License 2.0 (permissive), which allows commercial and private use with minimal restrictions—suitable for most projects.

Quickstart

pip install 'ansible-navigator[ansible-core]'
ansible-navigator --help
ansible-navigator run site.yaml -i inventory.yaml

By default runs Ansible in a container (podman or docker required); use --execution-environment false to run locally, but then Ansible and collections must be installed manually on the system.

Verify before relying

• Whether the container runtime requirement (podman/docker) is a blocker for your environment or if local execution mode is sufficient for your workflow.
• Performance characteristics when browsing large inventories or collections in interactive mode.

Package facts

Evidence: ansible_navigator-26.8.0-py3-none-any.whl

Keywords: ansible

Tags

More Utilities packages