Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
0e461dc
Add cmux SSH blog post
lawrencecchen Mar 31, 2026
5417bdf
Shorten SSH blog post, remove headings
lawrencecchen Mar 31, 2026
0fe69fe
Trim SSH blog post to 2 paragraphs
lawrencecchen Mar 31, 2026
fe27dbb
Remove first person, add feature bullet list
lawrencecchen Mar 31, 2026
31a14f5
Clarify no port forwarding needed
lawrencecchen Mar 31, 2026
0ead71d
Add cmux claude-teams and cmux omo blog posts
lawrencecchen Mar 31, 2026
59cfa9e
Wrap command names in code tags
lawrencecchen Mar 31, 2026
01e6eeb
Add code tags to SSH post, shorten claude-teams and omo paragraphs
lawrencecchen Mar 31, 2026
59d7c75
Reorder blog posts: SSH first, then claude-teams and omo
lawrencecchen Mar 31, 2026
98c2001
Update omo post with actual oh-my-openagent details, improve titles
lawrencecchen Mar 31, 2026
cdcf9ac
Add GPL blog post, fix omo title to specialist agents
lawrencecchen Mar 31, 2026
ec16f85
Explain what the relay daemon is for in SSH post
lawrencecchen Mar 31, 2026
6ef6e36
Move drag-image to second bullet, use routes through
lawrencecchen Mar 31, 2026
d7bd158
Rewrite SSH intro, add image upload video
lawrencecchen Mar 31, 2026
e4c92bf
Add SSH docs page, link blog posts to docs
lawrencecchen Mar 31, 2026
543c3cb
Add omo demo video to blog post
lawrencecchen Mar 31, 2026
40ca741
Trim omo agent details
lawrencecchen Mar 31, 2026
0948897
Lead omo paragraph with cmux omo command
lawrencecchen Mar 31, 2026
954f89b
Rename omo title to oh-my-openagent subagents
lawrencecchen Mar 31, 2026
3152034
Add claude-teams demo video to blog post
lawrencecchen Mar 31, 2026
367dc8e
Fix omo naming, link to docs instead of blog posts
lawrencecchen Mar 31, 2026
4569f75
Add demo videos to SSH blog, SSH docs, claude-teams docs, omo docs
lawrencecchen Mar 31, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
107 changes: 107 additions & 0 deletions web/app/[locale]/blog/cmux-ssh/page.tsx
Original file line number Diff line number Diff line change
@@ -0,0 +1,107 @@
import { useTranslations } from "next-intl";
import { getTranslations } from "next-intl/server";
import { buildAlternates } from "../../../../i18n/seo";
import { Link } from "../../../../i18n/navigation";

export async function generateMetadata({ params }: { params: Promise<{ locale: string }> }) {
const { locale } = await params;
const t = await getTranslations({ locale, namespace: "blog.cmuxSsh" });
return {
title: t("metaTitle"),
description: t("metaDescription"),
keywords: [
"cmux", "SSH", "remote development", "terminal", "macOS",
"port forwarding", "notifications", "AI coding agents",
"Claude Code", "remote workspace", "developer tools",
],
openGraph: {
title: t("metaTitle"),
description: t("metaDescription"),
type: "article",
publishedTime: "2026-03-30T00:00:00Z",
},
twitter: {
card: "summary_large_image",
title: t("metaTitle"),
description: t("metaDescription"),
},
alternates: buildAlternates(locale, "/blog/cmux-ssh"),
};
}

export default function CmuxSshPage() {
const t = useTranslations("blog.posts.cmuxSsh");
const tc = useTranslations("common");

return (
<>
<div className="mb-8">
<Link
href="/blog"
className="text-sm text-muted hover:text-foreground transition-colors"
>
&larr; {tc("backToBlog")}
</Link>
</div>

<h1>{t("title")}</h1>
<time dateTime="2026-03-30" className="text-sm text-muted">
{t("date")}
</time>

<p className="mt-6">{t("intro")}</p>

<h2>{t("problemTitle")}</h2>
<p>{t("problemP1")}</p>
<p>{t("problemP2")}</p>

<h2>{t("howTitle")}</h2>
<p>{t("howP1")}</p>

<pre className="bg-zinc-900 text-zinc-100 rounded-lg p-4 my-4 overflow-x-auto text-sm">
<code>cmux ssh user@devbox</code>
</pre>

<p>{t("howP2")}</p>
<p>{t("howP3")}</p>

<h2>{t("browserTitle")}</h2>
<p>{t("browserP1")}</p>
<p>{t("browserP2")}</p>

<h2>{t("notificationsTitle")}</h2>
<p>{t("notificationsP1")}</p>
<p>{t("notificationsP2")}</p>

<h2>{t("agentsTitle")}</h2>
<p>{t("agentsP1")}</p>

<pre className="bg-zinc-900 text-zinc-100 rounded-lg p-4 my-4 overflow-x-auto text-sm">
<code>{t("agentsCode")}</code>
</pre>

<p>{t("agentsP2")}</p>

<h2>{t("architectureTitle")}</h2>
<p>{t("architectureP1")}</p>
<p>{t("architectureP2")}</p>
<p>{t("architectureP3")}</p>

<h2>{t("detailsTitle")}</h2>
<p>{t("detailsP1")}</p>
<p>{t("detailsP2")}</p>
<p>{t("detailsP3")}</p>

<p className="mt-6">
{t.rich("cta", {
link: (chunks) => (
<Link href="/docs/getting-started">{chunks}</Link>
),
github: (chunks) => (
<a href="https://github.com/manaflow-ai/cmux">{chunks}</a>
),
})}
</p>
</>
);
}
2 changes: 2 additions & 0 deletions web/app/[locale]/blog/page.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -18,13 +18,15 @@ export async function generateMetadata({
}

const blogSlugs = [
"cmuxSsh",

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Add locale strings before listing the new blog post

Adding cmuxSsh to the blog index makes t('posts.cmuxSsh.*') resolve on every locale, but this commit only adds the new keys in web/messages/en.json; e.g. web/messages/ja.json has no blog.cmuxSsh or blog.posts.cmuxSsh, so /ja/blog and /ja/blog/cmux-ssh now fall back to English content instead of localized copy. Since this project’s localization policy requires user-facing text to be translated for supported locales, this is a regression for non-English users.

Useful? React with 👍 / 👎.

"cmdShiftU",
"zenOfCmux",
"showHnLaunch",
"introducingCmux",
] as const;

const slugToPath: Record<string, string> = {
cmuxSsh: "cmux-ssh",
cmdShiftU: "cmd-shift-u",
zenOfCmux: "zen-of-cmux",
showHnLaunch: "show-hn-launch",
Expand Down
8 changes: 8 additions & 0 deletions web/app/[locale]/components/blog-posts.ts
Original file line number Diff line number Diff line change
@@ -1,4 +1,12 @@
export const blogPosts = [
{
slug: "cmux-ssh",
key: "cmuxSsh",
title: "cmux SSH",
date: "2026-03-30",
summary:
"One command gives you persistent remote sessions, browser panes that reach remote ports, and agent notifications that come home.",
},
{
slug: "cmd-shift-u",
key: "cmdShiftU",
Expand Down
1 change: 1 addition & 0 deletions web/app/sitemap.ts
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ export default function sitemap(): MetadataRoute.Sitemap {
{ path: "/blog/show-hn-launch", lastModified: "2026-02-21", changeFrequency: "monthly" as const, priority: 0.7 },
{ path: "/blog/introducing-cmux", lastModified: "2026-02-12", changeFrequency: "monthly" as const, priority: 0.7 },
{ path: "/blog/zen-of-cmux", lastModified: "2026-02-27", changeFrequency: "monthly" as const, priority: 0.7 },
{ path: "/blog/cmux-ssh", lastModified: "2026-03-30", changeFrequency: "monthly" as const, priority: 0.7 },
{ path: "/blog/cmd-shift-u", lastModified: "2026-03-04", changeFrequency: "monthly" as const, priority: 0.7 },
{ path: "/docs/getting-started", lastModified: "2026-03-18", changeFrequency: "monthly" as const, priority: 0.9 },
{ path: "/docs/concepts", lastModified: "2026-03-18", changeFrequency: "monthly" as const, priority: 0.8 },
Expand Down
36 changes: 36 additions & 0 deletions web/messages/en.json
Original file line number Diff line number Diff line change
Expand Up @@ -112,6 +112,10 @@
"metaTitle": "The Zen of cmux",
"metaDescription": "cmux is a primitive, not a solution. It gives you composable pieces and your workflow is up to you."
},
"cmuxSsh": {
"metaTitle": "cmux SSH: remote development without the plumbing",
"metaDescription": "One command gives you persistent remote sessions, browser panes that reach remote ports, and agent notifications that come home."
},
"cmdShiftU": {
"metaTitle": "Cmd+Shift+U",
"metaDescription": "How Cmd+Shift+U navigates between finished agents across workspaces in cmux."
Expand All @@ -125,6 +129,38 @@
"metaDescription": "A native macOS terminal built on Ghostty, designed for running multiple AI coding agents side by side."
},
"posts": {
"cmuxSsh": {
"title": "cmux SSH: remote development without the plumbing",
"summary": "One command gives you persistent remote sessions, browser panes that reach remote ports, and agent notifications that come home.",
"date": "March 30, 2026",
"intro": "I SSH into remote dev servers constantly. Beefy cloud boxes for builds, GPU machines for inference, a Mac Mini on my desk for CI. Every session involves the same ritual: set up port forwarding for localhost previews, accept that notifications from coding agents won't reach me, and hope the connection doesn't drop while an agent is mid-task.",
"problemTitle": "The problem",
"problemP1": "SSH gives you a pipe to a remote shell. Everything else you need for development, you have to bolt on yourself. Want to see your remote dev server's UI? Forward the port manually, or remember the right -L flag. Want to know when Claude Code finishes a task on the remote machine? You don't, unless you're watching the terminal. Connection drops? Your session is gone (unless you also set up tmux or mosh).",
"problemP2": "These are all solved problems individually. Port forwarding exists. tmux exists. You can write a script to poll for notifications. But the cumulative friction adds up, and it gets worse when you're running multiple agents across multiple remote machines. Each one needs its own forwarding, its own session management, its own notification plumbing.",
"howTitle": "One command",
"howP1": "cmux ssh wraps all of this into a single workspace.",
"howP2": "That's it. cmux creates a new workspace, establishes the SSH connection using your existing ~/.ssh/config, and sets up everything behind the scenes: persistent session with automatic reconnect, browser pane proxying, bidirectional CLI relay, and file upload via drag-and-drop.",
"howP3": "If the connection drops, cmux reconnects with exponential backoff (3s, 6s, 12s, up to 60s). The session survives on the remote side, same as tmux. When the connection comes back, cmux reattaches and resizes using smallest-screen-wins semantics.",
"browserTitle": "Browser panes that see the remote network",
"browserP1": "This was the feature I wanted most. When you open a browser pane in a remote workspace, all HTTP and WebSocket traffic routes through the remote machine's network. Type localhost:3000 in the URL bar and you're looking at the dev server running on the remote box. No -L flags, no manual port forwarding, no SSH tunnel config.",
"browserP2": "Under the hood, cmux deploys a small relay daemon to the remote host on first connect (auto-detected platform and architecture, verified against a SHA-256 manifest). The daemon proxies browser traffic via SOCKS5 and HTTP CONNECT over the SSH connection's stdio channel. Each remote workspace gets an isolated WKWebsiteDataStore, so cookies and sessions are scoped per-connection.",
"notificationsTitle": "Notifications come home",
"notificationsP1": "The relay daemon also runs a bidirectional CLI relay. Processes on the remote machine can run cmux commands that execute on your local instance. When a coding agent calls cmux notify on the remote box, the notification appears in your local sidebar. The blue ring lights up on the right workspace tab. Cmd+Shift+U jumps to it.",
"notificationsP2": "The relay uses a reverse SSH tunnel (TCP, not Unix socket forwarding, because many servers disable AllowStreamLocalForwarding) with HMAC-SHA256 challenge-response authentication. Each SSH session gets its own relay port and token, so parallel sessions to the same host stay isolated.",
"agentsTitle": "Coding agents over SSH",
"agentsP1": "The cmux claude-teams and cmux omo commands both work inside SSH sessions. The Go relay daemon on the remote host handles the same tmux-compat translation that the local Swift CLI does.",
"agentsCode": "cmux ssh devbox\n# inside the remote session:\ncmux claude-teams",
"agentsP2": "Claude's teammate agents spawn as native cmux splits on your local machine, rendered in the sidebar with metadata and notifications, while the actual computation runs on the remote box. Same for OpenCode's multi-model subagents via cmux omo. You get the remote machine's resources with the local machine's UI.",
"architectureTitle": "How it works",
"architectureP1": "On first connect, cmux probes the remote host (uname -s, uname -m) and uploads a versioned cmuxd-remote binary if needed. The binary is a Go executable that speaks JSON-RPC over stdio. It handles three things: proxy streaming for browser traffic, session management for reconnect/resize, and CLI relay for remote-to-local command forwarding.",
"architectureP2": "The SSH connection uses ControlMaster multiplexing. The initial connection becomes the master, and subsequent operations (daemon bootstrap, relay tunnel, file transfers) reuse the same TCP connection. Cleanup runs ssh -O exit when the workspace is torn down.",
"architectureP3": "Drag a file into a remote terminal and cmux detects the foreground SSH process by TTY, then uploads via scp through the existing ControlMaster. The --no-focus flag lets scripts create SSH workspaces programmatically without stealing your current focus.",
"detailsTitle": "Small things",
"detailsP1": "Notification spam from flaky connections is suppressed with a 5-minute per-host cooldown and error fingerprint deduplication. Default keepalive options (ConnectTimeout=6, ServerAliveInterval=20, ServerAliveCountMax=2) are injected unless your config already sets them.",
"detailsP2": "The sidebar shows remote connection state: connecting, connected, reconnecting, error. Listening ports detected on the remote machine are clickable in the sidebar to open in the browser pane.",
"detailsP3": "cmux ssh reads the same flags you'd pass to ssh: -p for port, -i for identity file, -o for arbitrary SSH options. Everything interoperates with your existing setup.",
"cta": "Install cmux from the <link>getting started guide</link> or check the source on <github>GitHub</github>."
},
"cmdShiftU": {
"title": "Cmd+Shift+U",
"summary": "How Cmd+Shift+U navigates between finished agents across workspaces in cmux.",
Expand Down
Loading