Manage coding agents on Mac or Linux from your phone. Reply when needed. HQ is their command center: it tracks sessions, keeps lessons, and acts with your permission.
Manage coding agents and tmux sessions on your Mac or Linux server from your phone.
Install gtmux on your Mac or Linux server and pair your phone. Claude Code, Codex, other coding agents, and ordinary terminal panes will appear on your phone, so you can follow their progress and respond while you're away from your desk.
HQ (Headquarter)
HQ is the command center for your agents. It follows their sessions, works out what needs your decision and what can continue, then catches you up on what changed. It acts on your behalf only within the scope you authorize, with a record of every action.
As work progresses, HQ adds reusable lessons to your local knowledge base. It draws on what worked before when a similar task comes up. Your corrections and new evidence help it revise old lessons and its own approach, so it gets to know your projects and preferences over time.
Session status
The radar lists your panes and agents, using colors to show their status. For agents without a direct integration, gtmux can read the terminal screen to identify their state.
Replies and commands
Answer an agent or send a command to a terminal from your phone. Numbered choices appear as buttons. You can also bring a session to the front on your Mac. Pairing permissions control terminal input; read-only access cannot type into a pane.
Other features
• Get notified when an agent needs you or finishes.
• Start a new tmux session on your server from your phone.
• Check remaining quota, the tightest usage window, and its reset time.
• See the current agent's state on the Lock Screen and Dynamic Island.
• Share a link limited to the sessions you choose. Revoke it at any time; input access must be enabled separately.
• On iPad, the radar sits in the sidebar beside the open session, with room for HQ and pending decisions. Hardware keyboard shortcuts are supported.
• Available in English and Simplified Chinese.
Connecting
gtmux is free and open source, and runs on Mac and Linux. Connect from the phone app, terminal, browser, or gtmux attach on another computer. A menu bar app is also available on Mac. Install the server first, then pair your phone. Setup guide: ccy.dev/projects/gtmux.
Anywhere access can use a gtmux tunnel without a VPN. You can also connect over your own network. Agents continue running on your server.
Privacy
gtmux collects no data. There is no account. Your sessions and your token stay on your device and your Mac. Notifications are sent by your Mac through a relay, which forwards them to Apple's push service without storing them.
Ratings & Reviews
5.0
out of 5
3 Ratings
Servers and HQ
• Connect to Linux servers to manage their tmux sessions and coding agents.
• New access history shows when paired devices and browsers connected, what they requested, and the results.
• The companion Mac app adds an HQ workspace for tracking work, linked sessions, and recorded actions.
Conversations and controls
• Fixed Codex history being cut short by large tool output. Session updates recover more reliably on slow networks and when returning to the app.
• Keep your reading position when switching between wrapped and original-width terminal views, with a loading indicator during the change.
• Copy and share controls sit closer to each message. Continue typing after choosing or annotating an image.
• Larger terminal control keys, distinct Settings icons, and clearer session search and server details.
• Updated the built-in demo's conversations, HQ actions, and usage information.
Update gtmux on your server to use the new server features.
Version 1.0.121
The developer, Chaoyi Chen, indicated that the app’s privacy practices may include handling of data as described below. For more information, see the developer’s privacy policy .
Data Not Collected
The developer does not collect any data from this app.
Privacy practices may vary, for example, based on the features you use or your age. Learn More
The developer indicated that this app supports the following accessibility features. Learn More
Supported Features
Dark Interface
Differentiate Without Color Alone
Information
Seller
Chaoyi Chen
Size
30.9 MB
Category
Developer Tools
Compatibility
Requires iOS 15.1 or later.
iPhone Requires iOS 15.1 or later.
iPad Requires iPadOS 15.1 or later.
iPod touch Requires iOS 15.1 or later.
Mac Requires macOS 12.0 or later and a Mac with Apple M1 chip or later.