Clinch: Local-first, open-source fork of Warp built for agent session management

ponchopunchy1 pts1 comments

Clinch — a terminal built for Agentic Engineering

100% free · open source · no sign-in · no telemetry · local-first<br>Clinch<br>A terminal built for Agentic Engineering.<br>Every session auto-resumes on restart. Self-adapting UI. Quick-response and action buttons. One-click session transfers between Claude Code and Codex.<br>Install with Claude Code or Codex<br>Paste this prompt into your coding agent:<br>>Install Clinch Terminal from https://github.com/elliot-ylambda/clinch-terminal. Follow the official install instructions, review the installer source, and verify the release before installing.<br>copy

Or paste this directly into your terminal:<br>$curl -fsSL https://clinch.sh/install | shcopy<br>Unnotarized public preview for macOS 14+. The installer authenticates a signed release, verifies its digest, and stages Clinch in Applications. Read the installer source · View on GitHub →

remote controlbeta<br>clinch — clinch-terminal<br>clinch-terminal<br>claude · pr-47Done<br>codex · remote<br>cargo test

~/clinch-terminal<br>✳ claude · opus 5 · falcon-barrel<br>› hey claude, fix the PR #47 review comments<br>⏺ Reading PR #47 · 3 review comments<br>⏺ Editing remote/session.rs · lease.rs<br>⏺ cargo test · 5,927 passed<br>✓ Pushed 1 commit to falcon-barrel

typed on iPhone<br>over your tailnet<br>run on your Mac<br>9:41<br>claude · pr-47<br>tailnet · Elliot's Mac

› what's left on the milestone?<br>✓ 2 open · both assigned

› rebase onto main<br>✓ Rebased · 0 conflicts

› hey claude, fix the PR #47 review comments<br>✓ Pushed 1 commit to falcon-barrel

Message this session…↑

Send a line from your phone. It runs in the session already open on your Mac.<br>How it works →

$ clinch product tour<br>Every agent. Every project. One window.

Your browser does not support embedded video.

$ clinch features<br>Built for Claude Code and Codex<br>I run Claude Code and Codex all day, in a lot of tabs. Every feature below started with something I wanted in my own terminal. Click a feature for a short demo and the commit that introduced it.<br>+ automatic-worktree-tabs<br>When enabled, ordinary new terminal and Agent tabs in a local Git repository open in automatically generated linked worktrees on unique branches based on main. A Worktree chip identifies isolated tabs; unsupported repositories safely fall back to a normal tab.<br>▶ watch demo<br>+ terminal-toolbelt<br>Launch or resume Claude Code and Codex, open the project, and run common Git actions from a persistent button row under any plain terminal. Claude Code and Codex can also control Clinch itself — opening tabs, organizing sidebar sections, and creating or rearranging quick-insert buttons.<br>▶ watch demo<br>+ persistent-agent-context<br>Claude Code and Codex tabs can name themselves from the first recovered user prompt, while a pane-header control opens the session's locally recovered prompt history. That context stays attached through supported restore and resume flows.<br>▶ watch demo<br>+ agent-file-links<br>Cmd-click file paths emitted inside Claude Code and Codex TUIs to open them directly. Right-click to choose an application or the system default, copy the path, or reveal the file in Finder.<br>▶ watch demo<br>+ project-hover-overview<br>Hover a project tab to see its open-tab count and a compact list of Claude Code and Codex sessions, with live Working, Done, Needs attention, or Idle status — without switching projects.<br>▶ watch demo<br>+ shell-command-status<br>Muted tab indicators and project-level counts show ordinary foreground commands still running outside the current tab. When a background command finishes, Clinch leaves unread activity and a completion or error notification that returns to the originating pane.<br>▶ watch demo<br>+ agent-session-resume<br>When you have enabled session capture and the provider transcript is still recoverable, a normal quit or relaunch starts a new Claude Code or Codex process and asks it to resume the recorded conversation. Undo-close can restore it too; crash and power-loss recovery are best effort.<br>▶ watch demo<br>+ usage-meter-in-tab-bar<br>Claude Code and Codex transcript totals, estimated cost, and model names in the tab bar. Optional live Claude plan limits use the Claude Code credential in Keychain to query Anthropic after you enable them.<br>▶ watch demo<br>+ rate-limit-auto-continue<br>For an opted-in Claude Code or Codex pane, Clinch can count down a recognized rate-limit window and send "continue" when a known future reset time arrives.<br>▶ watch demo<br>+ attention-badges<br>Tab badges and native macOS notifications when the Claude Code or Codex integration reports that an agent is waiting. Notifications require macOS permission and compatible provider setup.<br>▶ watch demo<br>+ agent-attention-cycling<br>One shortcut focuses the next agent waiting on you, and the tab rail shows how many agents need attention.<br>▶ watch demo<br>+ conversation-finder<br>Reopen captured recent Claude Code and Codex conversations from the command palette, listed by first prompt and project folder. Resume still depends on a recoverable provider transcript.<br>▶ watch demo<br>+ quick-reply-buttons<br>Continue and LGTM...

claude clinch code codex demo terminal

Related Articles