navigera

navigera is extremely fast browser automation for AI agents, driven from the shell, one command per step. It is a single native binary (Rust, no Node) that speaks the Chrome DevTools Protocol directly:

• Pages come back as a compact accessibility tree with [ref=N] handles.
• Actions use real mouse and keyboard events.
• A named session keeps a warm browser alive between shell calls.
• New tabs, iframes, shadow DOM and alert/confirm dialogs work the same way.

Faster software for a better planet — less energy, less compute, more time for life.

Install

curl -fsSL https://raw.githubusercontent.com/andrey-usa/navigera/master/install.sh | sh

Windows (PowerShell):

irm https://raw.githubusercontent.com/andrey-usa/navigera/master/install.ps1 | iex

Or with a package manager: each one installs the same prebuilt binary:

Then give your agent the usage guide:

navigera install-skill        # -> ./.agents/skills (Gemini CLI, Codex, Cline, Kilo, …)
                              #    --claude -> ./.claude/skills, --continue -> ./.continue/skills

Platforms, and which browser navigera picks (for the fastest start, navigera install-browser chrome-headless-shell): Install.

Quick start

$ navigera -s work start
{"log":"/run/user/1000/navigera/work.log","pid":4242,"session":"work","socket":"/run/user/1000/navigera/work.sock"}
$ navigera -s work goto https://example.com
{"title":"Example Domain","url":"https://example.com/"}
$ navigera -s work title
Example Domain
$ navigera -s work quit
{"bye":true}

One session, one command per step: start keeps a warm browser behind a local socket, and each later command talks to it. navigera --help lists every command. A longer tour of the commands, targets and output: A first session.

For AI agents

• Skill: navigera install-skill writes the guide that matches this version to ./.agents/skills (--claude for ./.claude/skills, --continue for ./.continue/skills); navigera skill prints it.
• Claude Code plugin: /plugin install navigera --marketplace andrey-usa/navigera adds the skill to every session (what it contains).
• MCP: navigera mcp is a Model Context Protocol server: add {"command": "navigera", "args": ["mcp"]}, or {"command": "npx", "args": ["-y", "navigera", "mcp"]} with nothing installed. Per-client setup is on the MCP page; in the MCP Registry it is io.github.andrey-usa/navigera.
• Docs as markdown: llms.txt lists every page of the docs site, each one also served as .md.

The loop an agent runs: start a session, read the page with ax, act on

... View full README on GitHub