Repository navigation
CatPaw v0.2.0
From an agent's report of using CatPaw on a NAS:
- Downloads are saved to disk as they arrive, in
~/Downloads/CatPawby
default: no longer kept in memory and cut off at the response limit,
so large files work. The navigation answers at once with where the file
goes,wait({"for":"download"})waits until it is saved, and the
download view ofreadsays how far it is. settings, a new tool: shows CatPaw's settings and changes them, the
user approving each change, which is saved insettings.jsonnext to
the approval key:downloadDir, andlocalAddress, the address the
hand-off and approval pages listen on when the user's browser is on
another machine (they listened on 127.0.0.1 only).--download-dir,
--local-addressand--settings-fileset them from the command line.- The agent can take a hand-off back (
handoffwithend: true) when the
user cannot reach the page or will not finish, what they typed staying
masked; and a tab with the user can be closed. - Switching tabs shows what changed since the agent last saw the tab
(snapshot: "full"or"none"for the rest), not the whole page. - Clicks go through what does not take the pointer: a box with
pointer-events: none(a decorative overlay over a button) or
visibility: hiddenis not hit, its children may be; clicks no longer
stop at "covered by" such a box.
The library crates' public types changed (responses carry a saved file,
requests a download), hence 0.2.0.
Install
macOS (Apple silicon) and Linux (x86_64, aarch64):
curl -fsSL https://catpaw.sh/install.sh | sh
Windows (PowerShell):
irm https://catpaw.sh/install.ps1 | iex
The scripts download the archive for your system from this release and
check it against SHA256SUMS. Or download an archive below, check it
(sha256sum -c SHA256SUMS --ignore-missing), and put catpaw on your
PATH. Then connect it to your agent:
catpaw setup claude-code
Intel Macs and other systems: cargo install catpaw (Rust 1.91 or
later) builds it, see the README.