Skip to content
forktty_
Download
Claude Code

Run Claude Code in a visible agent workspace.

ForkTTY keeps Claude Code sessions inside native Linux terminal panes while adding lifecycle hooks, Agent HUD status, provider-aware team dispatch, and local MCP/socket context for review and orchestration.

Download for LinuxSource repository

Quick start

Use dry runs for setup, then launch a read-only Claude review worker when you want a visible second pass on a commit.

Preview Claude hook changes
forktty hooks setup claude --dry-run
Preview Claude MCP setup
forktty mcp setup claude --dry-run
Preview the Claude skill install
forktty skills setup claude --dry-run
Ask Claude for a visible review
forktty team review review-team claude-review --agent claude --task-id review-head --commit HEAD --submit

Provider-aware terminal handling

Claude Code's TUI can behave differently from simpler line-oriented tools. ForkTTY's team dispatch path stages Claude text, waits briefly, and sends Enter separately so prompts are less likely to stay stuck in the composer.

Review-friendly sessions

Claude workers can be launched as review lanes, implementation lanes, or QA lanes. The team state records the worker, provider, surface, task, mailbox, and final state so the leader can reconcile reports.

  • Read-only review prompts can be sent without giving the worker mutation scope.
  • Agent HUD highlights current pane, risky permission modes, and resumable sessions.
  • Team finish checks open tasks and live-looking workers before marking work done.

Local context, not hidden automation

ForkTTY does not add a background scheduler for Claude Code. Workflow loop state is durable metadata only; the actual agent work remains visible through terminal panes and explicit user-reviewed commands.

Questions

Does ForkTTY replace Claude Code?
No. Claude Code remains the agent CLI. ForkTTY provides the Linux workspace, pane management, hooks, notifications, and local automation surface around it.
Can Claude Code workers be reviewed in teams?
Yes. ForkTTY team state can launch, message, monitor, and clean up Claude Code workers with explicit role contracts.
Does ForkTTY send Claude prompts to a ForkTTY server?
No. Agent traffic goes through your configured Claude Code CLI and provider account. ForkTTY's own coordination state stays local.

Explore related ForkTTY pages

Team orchestrationAgent HUDMCPDocs

Get the alpha build

AppImage and .deb packages are published on GitHub Releases for Linux x86_64.

View releases