Orpheus
FAQ

Questions and plain answers.

The basics

What is Orpheus?

A control room for coding agents. It shows the Claude Code and Codex sessions running on your machines in one window, lets you type to one or many of them, and brings their questions to your phone.

Which agents does it work with?

Claude Code and Codex sessions running in tmux. The connector finds them on its own.

Do I need tmux?

Yes. The connector reads and types into tmux sessions. An agent started outside tmux is not visible to it.

Which systems does the connector run on?

macOS and Linux. It installs as a launchd or systemd user service, so it starts again after a restart.

Does Orpheus replace Claude Code or Codex?

No. It does not wrap them or sit between you and them. Your agents run as they do today, with the logins they already have. If you close Orpheus or remove the connector, they carry on.

Safety

Can Orpheus run commands on my machine?

No. The connector types text and a fixed list of nine keys into tmux sessions your policy exposes. The protocol has no message that runs a command. See Security.

What can Orpheus see?

The sessions your policy exposes: their names, whether they are working or waiting, their terminal output when you open them, and transcripts and usage readings if you share those. Plain shells are hidden unless you choose to show them.

Do I open a port or hand over an SSH key?

No. The connector dials out to Orpheus. We hold no SSH keys or passwords for your machines and have no way to connect in.

How do I cut a machine off?

Revoke the server in Orpheus and its connection closes at once. Or run orpheus-connector uninstall on the machine. Either side can end it.

Who on my team can type into an agent?

Members with the operator role or above. Viewers can watch only. Every send is written to the audit log.

Features

Can I use it from my phone?

Yes, in the phone's browser. Native iOS and Android apps are in development.

How does Orpheus know my usage limits?

If you allow it in the policy file, the connector reads each login's weekly and session percentage about once an hour and sends the numbers. Orpheus works out whether you are on track to run out before the reset.

Where do Decision Matrix recommendations come from?

From the Claude API, using your own workspace's decision history as context.

What is an Ask?

A question an agent sends you through the connector when it needs a decision. You answer in Orpheus, on any device, and the answer is typed back into its session.

Plans

What does Free include?

1 server, 3 agent sessions, 1 member, and Asks. No card and no time limit.

What does Pro add?

Unlimited servers and sessions, the Decision Matrix, Usage and Rooms. $20 a month or $200 a year, with a 14-day trial. The trial needs a card; $0 is due today. See Pricing.

What does Team add?

More members with roles, and the audit log. $50 per member per month.

Still deciding? Try it on one machine.