Documentation
Server & API
Hono server and route definitions in packages/nikcli/src/server.
HTTP Server
The server is implemented with Hono and SSE streaming. It supports CORS, optional basic auth, and exposes REST + event APIs.
Auth
Basic auth is enabled when NIKCLI_SERVER_PASSWORD is set.
Routes
| Namespace | Route File |
|---|---|
| /project | src/server/routes/project.ts |
| /session | src/server/routes/session.ts |
| /provider | src/server/routes/provider.ts |
| /mcp | src/server/routes/mcp.ts |
| /tui | src/server/routes/tui.ts |
OpenAPI
OpenAPI specs are exposed at /doc and generated with hono-openapi.
Networking Flags
--port | Port to listen on (default 0 = random). |
--hostname | Hostname to bind (default 127.0.0.1). |
--mdns | Enable mDNS; defaults hostname to 0.0.0.0. |
--cors | Additional CORS origins. |
CORS
Localhost and *.nikcli.store are always allowed.