Skip to content

first-run-standalone.md

Latest commit

 

History

History
51 lines (34 loc) · 1.07 KB

first-run-standalone.md

File metadata and controls

51 lines (34 loc) · 1.07 KB

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
  • Wayland clipboard access 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

  1. Start the host service in a terminal:

    RUST_LOG=info agent-portal-host

  2. In another terminal, verify connectivity:

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

  3. 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.