w2s

A postmodern web shell - server side.

Server that executes Wash Lua scripts in two stages over a persistent WebSocket, following the Wash architecture.

Layout

Clean architecture layers, with dependencies pointing inward:

cmd/api/                          composition root (wiring)
internal/domain/                  entities: Req, Res, Exec and the Exec List
internal/application/             use cases and ports: Processor, Exchange, ScriptRunner
internal/delivery/                interface adapters: HTTP routes and the persistent WebSocket
internal/infrastructure/          frameworks and drivers: Lua runtime (gopher-lua) and config
examples/                         Wash example scripts (hello.lua)

The Lua SDK lives in a separate repository and is injected by the server at runtime via wash_req and wash_command globals.

Run

cp .env.example .env
make run

Contributing

See CONTRIBUTING.md.