Portal

Overview

The Portal lets you connect to running Flaio sessions from another terminal window. This is useful for monitoring sessions, providing input, or managing multiple sessions across terminal windows.

Usage

Interactive Picker

Run flaio portal with no arguments to open an interactive picker showing all active sessions:

flaio portal

Select a session to connect and start receiving real-time terminal output.

Direct Connection

Connect directly to a specific session by ID:

flaio portal <session-id>

List Sessions

View a table of active sessions without connecting:

flaio portal --list

Features

Real-Time Mirroring

The portal mirrors the terminal output of the connected session in real time. You see exactly what the agent sees.

Input Forwarding

Type in the portal to send input directly to the connected session's agent.

Scrolling

Control	Action
Mouse wheel	Scroll up/down
Ctrl+U	Scroll up
Ctrl+D	Scroll down
PageUp	Scroll up
PageDown	Scroll down

Create Sessions Remotely

You can create new sessions through the portal picker without switching back to the main Flaio window.

How It Works

The portal communicates with the main Flaio process through a Unix socket at /tmp/flaio/portal.sock. The main Flaio instance must be running for the portal to connect.