Release status
Falkn is currently in private testing. Public App Store and macOS/Linux installation packages are not available yet. This page will carry the supported installation and upgrade instructions at launch.
System requirements
- a macOS or Linux host on ARM64 or x86-64;
- Codex or Claude Code installed and configured on that host;
- SSH access from the mobile app to the host;
- iOS 17 or later for the Falkn app; and
- network routing through the local network, VPN, or another SSH-accessible path.
Connection model
Falkn does not provide an SSH account or hosted shell. Add a machine using the host name or address, port, username, and authentication material for an SSH service you administer.
Verify the server's SSH host key before saving it. A local-network
address such as 192.168.x.x works only while the device
running the mobile app can route to that network. VPN addresses or DNS names may be used when
configured by the machine owner.
Session behaviour
- Detach
Control-B, thenQ, disconnects the terminal client without stopping the session.- Reconnect
- Run
falknin the same directory, attach by session ID, or open the session in the mobile app. - Restart
- A daemon or host restart ends live PTYs. Falkn retains session metadata and the final stored transcript.
- Notifications
- Optional alerts are suppressed while a terminal is attached or the mobile app conversation is actively open.
Diagnostic commands
falkn version
falknd version
falkn daemon status
falkn listWhen requesting support, include the client and daemon versions, operating system, CPU architecture, shell, and the exact error message. Do not send SSH private keys, passwords, API keys, or source code.
Support and security
General support: support@falkn.dev
Security reports: security@punklabs.ai. Please avoid filing public issues for vulnerabilities until a fix is available.