Tutorial: Portal standalone first run

Outcome

You run agent-portal-host and send successful requests with agent-portal-cli.

Prerequisites

agent-portal-host and agent-portal-cli installed
~/.agent-box.toml with [portal] enabled
wl-paste available on host if testing clipboard method

Minimal config

[portal]
enabled = true
socket_path = "/run/user/1000/agent-portal/portal.sock"

[portal.policy.defaults]
clipboard_read_image = "allow"
gh_exec = "ask_for_writes"

Steps

Start the host service in a terminal:
```
RUST_LOG=info agent-portal-host
```

In another terminal, verify connectivity:

agent-portal-cli ping
agent-portal-cli whoami

Optionally test image clipboard request:

agent-portal-cli clipboard-read-image --out /tmp/clip.bin

What you learned

Portal works independently of Agent-box
Portal methods are reachable over a Unix socket via official CLI

Next: Portal wrapper contract.