API reconnaissance framework
Discover • Map • Probe • Understand any API surface

INSTALL

curl -sSL https://bspippi1337.github.io/restless/install.sh | sh

eller

wget -qO- https://bspippi1337.github.io/restless/install.sh | sh

FIRST RUN

restless blckswan https://api.github.com

WHAT RESTLESS DOES

Restless automatically explores an API surface and builds a structural understanding of it.

Instead of manually browsing endpoints one by one, Restless performs automated reconnaissance.

Workflow:

target │ ▼ endpoint discovery │ ▼ probing & fuzzing │ ▼ documentation detection │ ▼ topology inference │ ▼ API insight

EXAMPLE

Routes discovered: 27

/users ├── /users/{id} │ ├── /repos │ └── /followers └── /orgs/{org}

CORE COMMANDS

restless discover restless inspect restless scan restless map

restless swarm restless magiswarm restless octoswan

restless auto restless blckswan restless smart

ARCHITECTURE

CLI │ ├─ application layer │ ├─ core engines │ ├─ discovery │ ├─ probing │ ├─ topology │ ├─ swarm engines │ └─ fuzzing │ ├─ modules │ ├─ OpenAPI intelligence │ ├─ export │ └─ sessions │ └─ infrastructure ├─ HTTP engine ├─ persistence ├─ logging └─ terminal UI

PHILOSOPHY

Discovery first
Assume nothing about an API and learn its structure dynamically.

Graph thinking
Treat APIs as connected systems rather than isolated endpoints.

Composable engines
Small probing engines combine into powerful reconnaissance pipelines.

PROJECT STRUCTURE

cmd/restless internal/core internal/modules internal/swarm internal/topology docs/ tools/

LICENSE

MIT