Reactive API discovery and Unix automation runtime.
Restless helps developers understand unfamiliar systems quickly.
It maps structure before extensive manual exploration is required.
- safe API discovery
- topology mapping
- filesystem-triggered command execution
- structural drift inspection
- shell-friendly output
- terminal-native workflows
Map a repository surface:
restless map .
Safely inspect a remote API:
restless scan https://example-api.dev
Watch a directory and react to changes:
restless watch . --run "make test"
Remote discovery uses only:
- GET
- HEAD
- OPTIONS
No mutation is performed during discovery.
Restless follows traditional Unix design principles:
- composable tools
- inspectable behavior
- shell interoperability
- local-first execution
- minimal runtime assumptions
The project intentionally avoids heavyweight orchestration layers.
Build locally:
make build
Install:
sudo make install
Restless aims to remain:
- Debian-friendly
- reproducibly buildable
- dependency-light
- terminal-native
- suitable for headless systems
Primary runtime code:
cmd/
internal/
Documentation:
docs/
Historical experiments and prototypes:
archive/
MIT
