Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

How to enable pi image paste via portal wrapper

Goal

Make image paste work transparently in pi sessions using portal-backed wl-paste wrapper.

Requirements

  1. Portal enabled in ~/.agent-box.toml
  2. If [portal].global = true, agent-portal-host running on host
  3. Wrapper binary (wl-paste) available in container PATH before system wl-paste

Steps

  1. Choose a Portal mode:

Global mode:

[portal]
enabled = true
global = true

Managed per-container mode:

[portal]
enabled = true
global = false
  1. If using global mode, start portal host:
agent-portal-host
  1. Spawn with Agent-box (portal enabled):
ab spawn -s my-session
  1. In container/session env:
export WAYLAND_DISPLAY=wayland-1
# AGENT_PORTAL_SOCKET is injected by ab when portal is enabled
  1. Validate wrapper flow:
wl-paste --list-types
wl-paste --type image/png --no-newline

Notes

  • Policy is enforced host-side by agent-portal-host.
  • Wrapper should not prompt in-container.