ScriptKittyInstall
ScriptKitty installs on Linux today. In testing The source is not published yet, so there is no download on this page.
Today it has run only in throwaway test machines. Until it leaves testing, put it on a machine you can lose.
Requirements
These are the requirements for the Linux build.
- A kernel with fanotify permission events. It has run on 6.12 only.
- Root, for the service.
- Python 3, with only its standard library.
- Disks formatted ext4, xfs or btrfs.
Install and check
Run the installer from the source folder. It installs and starts the service.
sudo ./install.sh # from the source folder; installs and starts the service
sk # how things are, and the latest changes
sk status # what is watched, what is left out, room held
See the first minute for what these show.
Uninstall
The same script removes it.
sudo ./install.sh --uninstall
Commands
An ordinary user can undo only what they could have changed by hand, and sudo includes everyone's changes.
| Command | What it does |
|---|---|
sk | Shows how things are, and the latest changes. |
sk status | Shows what is watched, what is left out, and the room held. |
sk list | Lists the changes it saw lately, newest at the bottom. |
sk show 12 | Shows which files change 12 touched. |
sk undo 12 | Puts one change back. |
sk undo --last | Undoes the latest change. |
sk back 10m, sk back 14:32, sk back m1234 | Puts everything back as it was ten minutes ago, at a clock time, or at a bookmark. |
sk back 1h --only ~/project | The same, for one folder. |
sk mark | Saves a bookmark. |
sk space | Shows how much room the old copies take. |
sudo sk keep 3d | Changes the keep time from the default 24 hours to three days. |
sk held | Lists files that had no room for a copy, and changes waiting for room right now. |
sudo sk free PATH | Lets go of one file's old copies. |
sudo sk watch DISK | Watches a disk that is not watched on its own, such as a USB stick. |
sudo sk unwatch DISK | Stops watching a disk. Until then, a watched disk answers "target is busy" to umount. |
Cloud commands
Coming for real clouds. The cloud engine is built and was tried only against made-up APIs, and never against a real cloud. The commands exist as follows.
| Command | What it does |
|---|---|
sudo sk cloud setup | Makes the engine's certificate and starts it. |
sudo sk cloud add-key GITHUB_TOKEN --host api.github.com | Gives the engine a real key for one host, read from input. It prints the stand-in the agent gets. |
sudo sk cloud env | Prints the lines to give the agent: the proxy, the certificate and the stand-ins. |
sk cloud status | Shows the state of the cloud engine. |
sk cloud list | Lists the cloud calls it wrote down. |
sudo sk cloud undo ID | Puts one call back. |
Mac and Windows
Neither is available yet, and both are coming.
- Mac: built, not run The code is written and passes 25 checks against a stand-in platform. It has never run on a real Mac.
- Windows: built, not run The code is written and passes 9 checks against a stand-in. It has never run on a real Windows PC.
Next: what it cannot undo, read before you install.