Skip to content
forktty_
Download
Codex

A Linux-native workspace for Codex.

ForkTTY keeps Codex in visible terminal panes. It adds workspace focus, splits, notifications, optional lifecycle metadata, and git worktrees without proxying model traffic or deciding how the agent should work.

Download for LinuxSource repository

Quick start

Launch ForkTTY, open a terminal pane, and optionally install lifecycle hooks.

Start the app
forktty
Preview Codex hooks
forktty hooks setup codex --dry-run
Inspect tracked sessions
forktty agent-health --json

Visible agent work

Codex runs as a normal process in a Ghostty-backed pane, so prompts, approvals, tests, and repository commands remain visible and inspectable.

Worktree isolation

Use a separate git worktree workspace when two agents need to edit in parallel. ForkTTY manages the terminal and repository boundary, not the agents' task graph.

Local-first

Bring your own Codex CLI and account. ForkTTY does not provide model access and does not send agent traffic through a ForkTTY service.

Questions

Does ForkTTY include Codex access?
No. Use your own Codex CLI and subscription.
Can ForkTTY resume Codex sessions?
Optional hooks can record enough lifecycle metadata for supported resume flows.
Does ForkTTY orchestrate Codex workers?
No. Agents are ordinary terminal processes; use panes and worktrees to organize them.

Explore related ForkTTY pages

Agent HUDGit worktreesGhostty terminalDocs

Get the alpha build

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

View releases