How to Use xtty: The Beginner's Guide

CodexFuse Team · 2026-11-03T23:24:30.656Z · 10 min read min read

How to Use xtty: The Beginner's Guide

If you want to learn how to use xtty, start here: this xtty terminal tutorial covers xtty the Mac terminal app (xtty.sh) built for everyday SSH and coding-agent work, and its whole pitch is that you spend your time on the work instead of wrestling with the terminal. One important disambiguation up front: xtty the terminal app (xtty.sh) is not the Unix stty command that sets terminal line settings, and it has nothing to do with the TTY concept of text terminals. With that out of the way, this guide walks you from first launch through SSH config and jump hosts, macOS Keychain password autofill, tabs and panes, and the agent-status view that tracks your Claude Code and Codex sessions. If you are comparing terminal apps, our Ghostty beginner guide covers the zero-config GPU terminal many Mac developers start with.

What Is xtty?

xtty is a native macOS terminal application built with Rust, GPUI, and Metal, designed to make everyday SSH and coding-agent work easier. Its homepage tagline sums up the philosophy: "Spend your time on the work, not the terminal." The maker's own framing is that a terminal should not try to become Iron Man — it should work like JARVIS: quietly excellent at its job, never the star of the show.

Under the hood, xtty uses Zed's GPUI framework and Metal for local rendering, which the site describes as Metal GPU-accelerated rendering as fast as Ghostty. It is a real shell — you keep working in the shell you already use — with built-in workflows for SSH connections, session management, file transfer, and coding agents. It is macOS-only (Apple Silicon and Intel, macOS 15 and later), solo-built by an indie developer named Jason, and it launched publicly on ProductHunt on October 19, 2026, billed as xtty 1.0. A community forum at xtty.sh/discuss hosts usage discussion and feedback.

How Do You Install xtty and Do the First Launch?

Getting the xtty Mac terminal running takes a few minutes: download it from xtty.sh, install it like any Mac app, open it, and you are looking at a fast local shell that is already wired for SSH.

1. Download from xtty.sh. Head to the homepage and grab the macOS build. It runs on Apple Silicon and Intel Macs on macOS 15 or later — there is no Windows or Linux version, and the maker has confirmed the focus is "macOS today."
2. Install and open. Install the app the usual Mac way and launch it. You land in a real local shell with tabs, splits, and the command palette ready — fonts, ligatures, light and dark themes, regex scrollback search, and ⌘-click on URLs and file paths all work out of the box.
3. Try the free edition. xtty ships with a free edition, and new users get a 7-day Pro trial. If you keep it, Pro is a one-time purchase of US$29.90 with no subscription (pricing verified November 3, 2026).
4. Point it at your SSH setup. xtty reads the SSH configuration and keys you already trust — there is no proprietary protocol, no extra server agent, and no SSH setup to rebuild. Your saved credentials stay in macOS Keychain, never on a vendor server.
5. Run your first agent session. Open a tab, start Claude Code or Codex as you normally would, and watch the agent-status view pick it up. You are now set up end to end.

How Do You Connect Over SSH in xtty?

You connect the way you already do: xtty is native OpenSSH, so it follows your existing keys, aliases, and ProxyJump routes automatically. There is nothing proprietary to learn — pick a saved host or type in the command palette and xtty takes care of the connection path, including jumping through a jump host to reach the real destination ("Through the jump host, straight to work").

Three connection features are worth learning on day one. Batch SSH login opens every machine you need at once from your saved hosts, so a morning standup stack is one action instead of five. Duplicate Tab opens another independent SSH connection in the same remote directory — same server, same working directory, no extra SSH command — which is ideal when you want a second pane on the same box without re-navigating. And if you manage lots of hosts, the companion approach of a dedicated connection manager still has its place: our LazySSH beginner guide covers the SSH connection-manager CLI lane, while xtty is the terminal app with SSH built in.

How Does the Keychain Password Autofill Work?

Keychain autofill is the feature that ends password-typing drudgery: when a familiar password prompt appears in a session, xtty fills the matching credential from macOS Keychain. The site's line for it is "You've typed this password enough."

This matters because SSH life on macOS is full of prompts — jump hosts, bastions, sudo on the remote box — and the xtty ssh autofill behavior treats them as a solved problem rather than a ritual. Because the credentials live in Keychain, they stay local to your Mac; the homepage states it plainly: "Credentials stay local — Your saved credentials stay in macOS Keychain." Nothing about your logins travels to a vendor server.

How Do You Work with Tabs, Panes, and Broadcast Input?

xtty's workspace model is straightforward: tabs can sit down the side or across the top, and panes can be dragged, snapped, and resized to give each task the space it needs. Each pane is an independent session, so you can watch logs in one, run a build in another, and keep an SSH session open in a third.

Broadcast input is the power move: select the panes you want, type a command once, and it goes only to those panes — "One command, only where you need it." The ProductHunt launch post emphasizes the deliberate scope: you send input only to the panes you deliberately select, and everything outside that selection stays untouched. That makes rolling restarts across a fleet of servers, or parallel test runs on several boxes, a single typing session instead of a copy-paste marathon. And when you need a session that survives a dropped connection rather than a dropped laptop lid, pairing xtty with a multiplexer still helps — our tmux beginner guide shows how persistent sessions fit into the SSH workflow.

What Is the Agent Status Feature?

Agent status is xtty's coding-agent dashboard: it shows each agent's status at a glance — Working, Needs You, or Done — so you can jump back to the right session the moment it needs you instead of babysitting tabs. That glanceable state is the whole point of the xtty agent status feature. The agents live inside ordinary terminal tabs; there is no separate dashboard competing for your attention.

The supported agents named on the homepage are Claude Code and Codex. In practice this means you can fire off a long Codex task in one tab, switch to reviewing a Claude Code change in another, and let the status view tell you which one is waiting on input. It is the feature that most clearly separates xtty from a plain terminal: the app understands that your terminal now hosts agents, not just commands, and it treats their state as first-class.

xtty vs Ghostty: Which Should You Pick?

Pick xtty if your day is SSH sessions and coding agents; pick Ghostty if you want the fastest zero-config local terminal and will wire up SSH yourself. The two are not rivals so much as answers to different questions.

The honest differentiator is workflow, not speed: xtty's homepage meta description positions it as having "built-in workflows for SSH, sessions, file transfer, and coding agents," while Ghostty's lane is raw terminal excellence with zero configuration. If the SSH autofill and agent-status arc described in this guide sounds like your workday, xtty is the one to try.

How Much Does xtty Cost?

xtty is free to start, with an optional Pro upgrade: new users get a 7-day Pro trial, and Pro costs US$29.90 as a one-time purchase with no subscription. A free edition exists alongside it — those three figures were verified on the xtty.sh homepage on November 3, 2026.

One caveat worth stating once: the exact split between what the free edition includes and what requires Pro is not stated on any public page found during research, so treat the trial as your evaluation window and confirm the current feature split on xtty.sh before buying.

xtty Feature Map

Sources

xtty.sh homepage (xtty.sh — tagline, feature descriptions, pricing, platform support; fetched November 3, 2026). ProductHunt launch post by Jason (@JasonXu), "xtty: Stop wrestling with terminals. Build something that matters." (published October 19, 2026; tagline, tech stack, batch login, broadcast, agent sessions). SteemHunt launch blurb by @jholaba on Steemit, "xtty — A terminal that makes everyday work easier" (posted October 21, 2026; feature summary). xtty.sh/discuss community forum (launch-era discussion channel).

Frequently Asked Questions

Is xtty free?

Yes, there is a free edition, plus a 7-day Pro trial. Pro is a one-time purchase of US$29.90 with no subscription (verified November 3, 2026).

Does xtty work on Windows or Linux?

No. xtty is macOS-only — Apple Silicon and Intel, macOS 15 or later — and the maker has confirmed the focus is "macOS today."

Is xtty the same thing as stty?

No. xtty is a terminal application from xtty.sh; stty is the Unix command that reports and changes terminal line settings. They share letters and nothing else.

Which AI coding agents does the agent-status feature support?

The homepage names Claude Code and Codex. Their sessions run in ordinary terminal tabs, and xtty surfaces each agent's Working, Needs You, or Done state at a glance.

Where does xtty store my SSH passwords?

In macOS Keychain, on your Mac. The homepage states that saved credentials stay local — they are never sent to a vendor server.