CLIENT QUICKSTART

Wake your first agent session

Install the local AWP client, connect a provider, and bind an existing Codex session.

Install AWP

The installer supports macOS and Linux on AMD64 and ARM64. It verifies the release checksum and installs without sudo.

curl -LsSf https://awp.manifestro.io/install.sh | sh

awp version
awp help

Requirements

An AWP provider URL and token, an authenticated Codex CLI, and an existing Codex session to resume.

Add a provider

Tokens stay in environment variables and are never written into the main configuration file.

export MY_PROVIDER_TOKEN="your-token"

awp config set \
  --provider my-provider \
  --service-url wss://provider.example/awp \
  --device-id dev_my_macbook \
  --token-env MY_PROVIDER_TOKEN

Bind a session

The opaque AWP session ID is shared with the provider. The Codex runtime session ID remains only on your machine.

awp sessions bind \
  --provider my-provider \
  --session-id ses_project \
  --adapter codex \
  --runtime-session-id <codex-session-id> \
  --workspace /absolute/path/to/project \
  --metadata-json '{"repository":"Manifestro/awp"}'

Validate and run

awp doctor
awp daemon

When the provider delivers an event for ses_project, AWP resumes the mapped Codex session and acknowledges the result as completed or failed.

Optional macOS autostart

Installing AWP never starts a background service. Autostart is always explicit and reversible.

awp autostart enable --start-now
awp autostart status
awp autostart disable