Firekeep Hands

Hands is a local MCP server plus a local approval broker: it lets any runtime connected to your Keep perceive the active window, accessibility tree, and screen, and act on your computer — focusing and launching apps, invoking controls, typing, driving the browser — with every consequential step gated behind your explicit, in-the-moment approval.

Hands is turned on with firekeep hands enable, the only supported install path. The wheel imports firekeep_client.resolver, firekeep_client.state, and firekeep_client.hooklog from the Client Kit's own venv at runtime, and deliberately does not declare firekeep-client as a dependency in pyproject.toml — that PyPI name is owned by a third party, so resolving it there would pull in unrelated code (see client/firekeep_client/cli.py). A bare pip install firekeep-hands outside the kit venv is therefore unsupported; it will import cleanly only where a Client Kit install already put firekeep_client on the path.

See docs/guides/hands.md for the full design: what Hands can perceive and do, the approval broker, protected-class actions, and the platform backends.

Running the test suite locally

Because the wheel imports firekeep_client at runtime without declaring it, installing hands alone is not enough — install the checkout's client first, exactly like firekeep hands enable finds it:

pip install -e client -e "hands[test]"
pytest hands/tests -q --ignore=hands/tests/live

hands/tests/live/ holds manual, real-target tests (e.g. driving an actual Notepad or TextEdit window); they self-skip outside an interactive desktop, and --ignore skips collecting them at all rather than relying on that.