Agent Handoff and the End of Zen Mode

Sometimes you have to kill a feature you genuinely liked building. Zen Mode is that feature for us.

🧘 What Zen Mode Was

Zen Mode was CrewHub’s full-screen, tmux-inspired workspace. Chat panels, session switching, keyboard shortcuts, custom themes like Tokyo Night. It turned the 3D dashboard into a focused agent interaction UI where you could talk to your agents without distractions.

And honestly, it worked. People used it. We were proud of it.

But it was fighting a losing battle.

🌊 The World Moved

Claude Desktop now ships with Claude Code built in. Codex has its own terminal UI. iTerm2 and Warp are purpose-built for exactly this kind of interaction, and they’re improving faster than we ever could.

We were building a custom chat interface inside a 3D dashboard, competing with tools that have entire teams focused on nothing but terminal interaction. Every week, the gap between what Zen Mode could do and what native tools offered got a little wider.

At some point you have to ask: are we adding value here, or just duplicating effort?

The answer was pretty clear.

🎯 What CrewHub Actually Does Best

CrewHub’s strength was never interaction. It’s orchestration. Monitoring agents across sessions, seeing what’s running, understanding workload, managing rooms and assignments. That’s the stuff no terminal app does.

So instead of maintaining a parallel universe, we’re leaning into what makes CrewHub unique. Let it be the control tower. Let the terminals be terminals.

🔀 Enter Agent Handoff

We’re currently building Agent Handoff on the feature/agent-handoff branch. The idea is simple: every session card gets a “Continue in…” split button. Click it, and CrewHub does the plumbing for you.

It resolves the session key to a Claude CLI session ID, builds the right claude --resume <session-id> command, and opens your preferred terminal with the command ready to go.

It auto-detects what you have installed: iTerm2, Warp, Terminal.app, VS Code’s integrated terminal. If none of those work, it falls back to copying the command to your clipboard. You’re never stuck.

Two API endpoints make it work:

• GET /api/handoff/targets auto-detects your available terminals
• POST /api/handoff/sessions/{session_key} executes the handoff

That’s it. No new chat UI. No custom themes. No keyboard shortcut system to maintain. Just a bridge from “I see what this agent is doing” to “now I want to talk to it directly.”

🤝 The Trade-off

Zen Mode isn’t gone overnight. It’s still accessible via ?mode=zen in the URL for a transition period, but the on-ramps (the toolbar button, the keyboard shortcut, the auto-launch toggle) are being removed. Full removal is planned for v0.21.0.

If you built workflows around Zen Mode’s URL parameters, you have time to adjust. But the direction is set.

We think this is the right trade-off. Focus on what CrewHub does best, and let purpose-built tools handle the rest. Less surface area to maintain, better experience for everyone.

🚧 Still In Progress

Agent Handoff is actively being developed. The macOS implementation is taking shape, but Linux and Windows support, Codex integration, and Claude Desktop deep linking are still on the roadmap. We’re building it in the open, so if you want to follow along or have opinions, come find us on Discord.

Zen Mode served its purpose. It taught us what people actually need from CrewHub, and it turns out the answer is: help me orchestrate, then get out of the way.

That’s exactly what Agent Handoff does.