A navigation memory for AI agents
Your agent recalls the route — instead of re-exploring.
webnav remembers how to get around websites. A deterministic, zero-LLM navigation memory: agents walk known routes page-to-page — cheap, reliable, self-healing — and spend their expensive reasoning on judging results, not re-finding them.
git clone https://github.com/lucyfuur94/webnav-core && cd webnav-core
npm install && npm link
webnav walk --start www.saucedemo.com:login \
--goal www.saucedemo.com:checkout-completeThe problem
Agents explore the same pages, forever.
Burned tokens
Every run re-discovers the same buttons, the same forms, the same flows. LLM-driven navigation pays the full reasoning bill for pages it has seen a hundred times.
Slow walks
Screenshot → think → click loops cost seconds per step. A route the agent already knows shouldn’t need any thinking at all.
Flaky runs
Same task, different path every time. Non-deterministic navigation makes agent flows impossible to trust, reproduce, or debug.
The fix
A graph that remembers.
Nodes are states
What’s true on a page and what you can do from it. A URL is an attribute of a state — not the state itself.
Edges are actions
Click / type / navigate transitions, each carrying cost, reliability, and a confidence that decays with age and rises with use.
Recall, don’t re-explore
The second time an agent needs to get somewhere, it replays the known route deterministically — zero LLM on the journey.
Self-healing on use
When a remembered step drifts, the walk asks once, writes the fix back, and the next run is deterministic again.
Everything runs on your machine.
The CLI is free forever. Build and own your maps locally — they persist and self-heal on use. No account, no key, no limits. If you like where this is going, star the repo — it's the best way to support the project.
git clone https://github.com/lucyfuur94/webnav-core cd webnav-core && npm install && npm link webnav --helpView on GitHub ↗
Your logins never leave your laptop.
webnav only ever moves the map — the navigation skeleton of a site. Site credentials live locally at ~/.webnav/credentials.json (chmod 600) and are filled by the browser on your machine at walk time. The hosted service, when it ships, has no credential storage by design.
Roadmap
Coming soonShared knowledge, hosted for you.
The open-source CLI is just the start. The hosted layer turns everyone's maps into one living, self-healing graph — and serves it over an API.
Hosted common map
soonOne shared, self-healing graph we maintain — healed by every walk, so it’s always current. Stop cold-starting on sites the community already mapped.
Map API
soonFetch any site’s graph over the network instead of building your own. One call returns the navigation skeleton your agent walks locally.
Accounts & dashboard
soonSign in, grab an API key, watch your usage. Login for general users opens with the hosted launch.
Want in first? Watch the repo — launches land there before anywhere else.