Terminal session infrastructure

Persistent agent sessions on machines you control.

Falkn runs Codex and Claude Code inside reconnectable terminal sessions on macOS and Linux. Use the native terminal interface locally, detach without stopping the process, and continue from an mobile app over SSH.

Mobile app App Store · Coming soon Source Private repository

01 / Interfaces

The original terminal locally. A focused client remotely.

Desktop attachment passes the PTY stream through unchanged, preserving each agent CLI's colour, cursor movement, and full-screen interface. The mobile app presents the same sessions through a mobile-native view.

Falkn command-line session list running in Terminal on macOS — Local session discovery and attachment on macOS.

Falkn command-line session list from a Linux host — The same daemon and session model on Linux.

Falkn's pre-release mobile app session list — Hosts and persistent sessions in the pre-release app.

Pre-release builds shown. Interface details may change before public availability.

02 / Architecture

The session stays with the host.

The daemon owns the agent process and pseudo-terminal. Clients attach to it; disconnecting a client does not stop the session.

Remote clientMobile app

SSH

Session ownerfalknd

PTY

Agent processCodex or Claude

Local clientTerminal

Unix socket

Session ownerfalknd

03 / Components

One session model, three surfaces.

falkn

macOS + Linux CLI

Discovers, creates, and attaches to sessions while leaving the agent's terminal rendering intact.

falknd

User-local daemon

Owns processes, terminal state, bounded history, metadata, and reconnectable client attachments.

Falkn

Mobile app

Lists, starts, renames, stops, and continues remote sessions without taking over an attached desktop terminal.

04 / Boundaries

Remote access remains behind SSH.

Falkn uses the authentication and network policy already configured on the user's machine. The daemon does not open a TCP listener.

Daemon socket: User-only Unix socket in a mode-0700 runtime directory.
SSH credentials: Stored in the iOS Keychain and sent only to the configured host.
Agent content: Not sent to the Falkn notification relay.
Notifications: Optional attention metadata encrypted before relay delivery.
Client disconnect: The session continues under falknd.
Host reboot: Live PTYs end; metadata and the final stored transcript remain.

05 / Availability

Private testing is in progress.

The mobile app and signed macOS/Linux packages are not yet publicly available. Installation and App Store links will be added here for the public release.

Hosts: macOS and Linux
Architectures: ARM64 and x86-64
Mobile: iOS 17 or later
Agents: Codex and Claude Code