Skip to content

v0.1.0 one command, no client

Latest

Choose a tag to compare

@feder-cr feder-cr released this 02 Sep 23:22

The first release of AIHawk as a package. Before this, the repository was
documentation for an MCP server you installed into somebody else's client. Now it
is the thing itself.

uvx aihawk ui --openrouter-key sk-or-...

Then open http://127.0.0.1:8765: the conversation on the left, the live browser
on the right. One command, one key, no client to install and nothing else to run.

aihawk do "..." is the same machinery with no page and an answer on stdout, for
scripts and cron. Literally the same: there is one loop in the package and one
call to the model, and the narration is a parameter rather than a mode.

Without a key it still starts. What answers is a placeholder that understands
five literal commands - go, read, click, type, tab, shot - which is
enough to see the interface work and to tell a browser problem from a model
problem without spending anything. It is not a fallback; it is how most of this
release was tested.

Nothing here has a privileged path to the browser. The interface talks to
invisible-playwright-mcp
over MCP, using the same fourteen tools any other client gets. That is the reason
to trust the tools are sufficient to build on: the flagship interface is a client
of them.

The key never reaches the browser process. It is stripped from the
environment the engine is started with, and a test fails if that stops being
true.

Requires invisible-playwright-mcp 0.9.0 or newer. The tab strip needs
session_list_pages to return id, title, url and which tab is active - four
fields its description had always promised and, until 0.9.0, had never returned.