# Headless server

`po-server` is Po's client-neutral execution process. It owns session runtimes, scoped server plugins, durable storage, and authenticated HTTP/WebSocket services. Browser and native clients present that work; they do not own agent execution.

The executable ships with `@agimon-ai/po` and requires Node.js 24 or newer. Do not add the distribution host to `presets.yaml` as an extension.

Start with [Getting started](getting-started.md). Use `--no-session` for a host that waits for clients to create sessions; otherwise startup creates an initial session. A host can own multiple workspaces and sessions in one process.

## Guides

- [Getting started](getting-started.md): private token file, launch options, and browser attachment.
- [Lifecycle](lifecycle.md): scope readiness, storage ownership, reloads, and shutdown.
- [Client protocol](ipc.md): scoped HTTP/WebSocket routes and state recovery.
- [Package APIs](api.md): handler registration, authority, and public Node entry points.
- [Contract export](api-export.md): compiled OpenAPI/AsyncAPI and coverage gaps.
- [Security](security.md): direct-client credentials, remote access, and execution boundaries.

The direct listener is not a public gateway or an execution sandbox. Read the security guide before exposing it.

## License

Business Source License 1.1: free for personal use, organisations under USD 1M revenue, non-profits and education. See [LICENSE](../../LICENSE) and https://agimon.ai/licensing.
