Repolode
Submit
no-phux

no-phux/phux

A tmux-style terminal multiplexer whose background server can be driven from scripts and coding agents via JSON CLI commands.

Open-source alternative to:tmux

View on GitHubWebsite
Stars
22
Forks
3
Open issues
42
Last commit
4 hours ago

What is it?

phux keeps shell sessions running in a background server and presents them in a terminal UI, similar to tmux. Its commands expose panes, input, screen snapshots and agent state, with JSON output and meaningful exit codes, so scripts and agents can start a shell, send it commands and read the results.

The server tracks which panes run a coding agent and whether that agent is working, idle, or waiting for input. Remote machines can be added with a host command over SSH-style addressing, and the project lists CLI, desktop app, WSL and Windows launcher installation options. Plugins and an MCP server (`phux mcp`) connect it to Claude Code, pi, OpenCode and similar tools.

The core product is the persistent server, CLI and terminal UI; remote hosts, agent integrations and the desktop app are optional. The desktop client is newer than the terminal UI, and the wire protocol is versioned as 1.x.

Key features

  • 01Keeps shells running in a background server that survives detaching.
  • 02Scriptable CLI commands for creating panes, sending input and taking snapshots, with JSON output.
  • 03Tracks which panes run coding agents and whether they are waiting on you.
  • 04Adds remote machines as hosts without a separate account.
  • 05Provides an MCP server and plugins for agent tools.

Use cases

  • Driving a long-running shell from a script and reading its output.
  • Letting a coding agent run commands in a terminal session you can later attach to.
  • Monitoring several coding agents across panes and machines.
  • Reattaching to shells on a remote machine from a local terminal.

Quick start

  1. 1

    Run the official install script from the README

  2. 2

    Start phux and attach to the server

    phux

Things to know

  • No Intel Mac or musl builds are provided.
  • On Windows, the CLI and server require WSL 2.
  • The desktop app is newer and rougher than the terminal UI.

In collections

Open-source AI agent frameworks & appsAI coding assistants & agentsCLI & terminal tools

Topics

#terminal#terminal-multiplexer#tmux#coding-agents#ai-agents#rust#remote#cli#agents#ghostty

FAQ

What is phux?
A tmux-style terminal multiplexer whose background server can be driven from scripts and coding agents via JSON CLI commands. phux keeps shell sessions running in a background server and presents them in a terminal UI, similar to tmux. Its commands expose panes, input, screen snapshots and agent state, with JSON output and meaningful exit codes, so scripts and agents can start a shell, send it commands and read the results.
Is phux free to use? What license does it have?
phux is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is phux still maintained?
Actively maintained. The last commit to phux was on Nov 7, 2026.
What can I use phux for?
Driving a long-running shell from a script and reading its output. Letting a coding agent run commands in a terminal session you can later attach to. Monitoring several coding agents across panes and machines. Reattaching to shells on a remote machine from a local terminal.
How do I install phux?
Run the official install script from the README Start phux and attach to the server: phux
Where can I get phux?
The source code and installation instructions are on GitHub: https://github.com/no-phux/phux

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects