Phren Hook · open source

Your agents.
Your computers.
One place to pick up.

Bring live conversations and Herdr terminals into Phren on your iPhone, alongside the memory, skills, and projects your agents use.

Continue the conversation

Codex, Claude Code, and Copilot chat, images, live updates, and the usage each agent reports.

Keep the context

Use project memory and skills in chat. Read diffs, explore running web apps, and switch to the exact terminal.

Stay on your machines

The helper runs locally. Your phone connects through pinned SSH, with Tailscale when you’re away.

Install on each computer

You’ll need macOS or Linux, Node 20+, Herdr, SSH, and lsof. Run as the same user who runs your agents.

npx --yes @phren/cli@0.2.14 bridge install
npx --yes @phren/cli@0.2.14 bridge doctor

The installer adds a LaunchAgent on macOS or a systemd user service on Linux. It preserves other agent hooks and SSH keys, and backs up files it changes.

  1. In Phren, open Agents → Add computer.
  2. Copy the SSH authorization line into that computer’s ~/.ssh/authorized_keys. Existing recognized Phren keys are migrated by the installer.
  3. Verify the SSH fingerprint shown by Phren against the computer.
  4. Keep Tailscale connected on both devices for remote access. No public port or Funnel is needed.

In Codex, review Phren’s new callbacks in /hooks. Resume existing agents if needed to load the callbacks. The helper connects to agents you run; it doesn’t start a coding agent automatically.

Know what’s happening

Chat updates follow the agent’s transcript writes. Token counts come from the agent. Phren keeps an exact computer, server, workspace, tab, pane, and conversation identity before sending a message.

Codex and Claude permission requests can appear in chat while you’re watching that conversation. Requests without a supported callback, including choice questions, stay accessible through Phren’s terminal.

Maintain your connection

npx --yes @phren/cli@0.2.14 bridge status
npx --yes @phren/cli@0.2.14 bridge update
npx --yes @phren/cli@0.2.14 bridge rollback
npx --yes @phren/cli@0.2.14 bridge uninstall

Updates install the CLI version you invoke. Rollback restores the previous helper version. Uninstall removes the service and Phren callbacks while retaining local data and backups. Remove the phone’s SSH key to revoke access.

Having trouble? Run bridge doctor, confirm SSH and Herdr are running, and check the phone’s authorization line. On Linux, use journalctl --user -u phren-hook; macOS logs live at ~/.local/share/phren/bridge/service.log.