Do I need a key or an account?
No. Despite what some listings claim, there is no key of any kind. Nothing talks to an outside service — the only setup is a folder path and a list of allowed commands.
Is it actually safe to let an assistant run commands?
The defaults are cautious: three read-only commands, a few flags, a length cap, a thirty-second timeout, and path checks that follow symlinks so nothing outside your chosen folder is reachable.
Can it delete or overwrite my files?
Not with the default list of ls, cat and pwd. It can only do that if you add something like rm or mv to the allowed list yourself.
What do the 'all' settings do?
They switch the safety off. Allowing all commands and all flags gives the assistant unrestricted use of your command line inside that folder, so treat those options as a deliberate choice rather than a convenience.
Can I use this to search through a folder of documents?
Yes — add grep or find to the allowed commands, point the folder setting at your documents, and then ask in plain language.
Is this project still maintained?
It works and is not archived, but the code has had no changes since July 2025 and no replacement project is named by the author.
How hard is it to set up?
You paste a config block listing your folder, allowed commands and allowed flags. The uv tool needs to be installed on your computer first.
