Farol icon

Farol A native macOS terminal for Claude Code, Codex and other AI coding agents.

Download for Mac GitHub

Free and open source, for Apple silicon on macOS 14+. Read the docs

Farol with a project open in the sidebar, its sessions working, waiting for you and done, Claude Code reviewing the change in the terminal, and the review panel with a note for the agent
Farol in its Dark theme, with the review panel open beside Claude Code
Farol in its Fog theme, with the review panel open beside Claude Code
Farol in its Navy theme, with the review panel open beside Claude Code
Farol in its Dusk theme, with the review panel open beside Claude Code
Farol in its Ember theme, with the review panel open beside Claude Code
Farol in its Dawn theme, with the review panel open beside Claude Code
Farol in its Light theme, with the review panel open beside Claude Code

Know which agent needs you

From task to pull request

The New Task sheet: the task typed in, a branch made from it, Claude Code picked, and Now beside Start for when it runs
The sidebar grouped by project, with sessions working, waiting for you with the agent's question and done, agents on two servers, and tasks for later
The review panel on the agent's changes, with a draft note under two README lines and Send 2 notes in its header, beside Claude Code's review in the terminal
The files panel with src/queue.ts open in the editor beside Claude Code
The git graph beside Claude Code: each agent's branch listed, and the history of commits under them
The ⌘P list searching for test: a session, the project's test command and the test files

Answer from your phone

When an agent waits, Farol for iPhone tells you. Read what it asks and answer from anywhere. Free and end-to-end encrypted, on the App Store.

Farol for iPhone listing sessions: Fix flaky CI tests needs you, Add fuzzy search is working, two more are done or idle
See who needs you
The Fix flaky CI tests session waiting for you: the agent asks what to do with its fix, with Run the tests and Commit and push to pick from
Read what it asks
The same session after answering Run the tests: the agent ran the suite 40 times and reports every test passes
Answer, and it carries on

Get Farol for iPhone

See Farol in motion

Questions

The docs cover every feature. For anything else, ask on Discord.

Read the docsAsk on Discord

What is Farol?

Farol is a free, open source terminal app for macOS made for agentic coding, where AI coding agents write the code and you supervise. Each agent runs in its own session, and Farol shows which one is working, which one is waiting for you and which one is done.

What is an agentic terminal?

A terminal built for AI coding agents as well as for typing commands. Agents like Claude Code and Codex already run in a terminal. An agentic terminal app such as Farol adds what you need to supervise several at once: a session per agent, live status, notifications and a review step before you ship.

How do I run several Claude Code agents in parallel?

Press ⇧⌘N, describe the task and pick an agent. Farol creates a git worktree on a new branch and starts Claude Code or Codex there, so each agent works on its own copy of the repo. Open as many as you like.

Which coding agents does Farol work with?

Claude Code, Codex, OpenCode and Pi report their status once connected in Settings → Agents. Any other agent that runs in a terminal works too, and can report its status through Farol's CLI or the terminal bell.

Is Farol a fork of Ghostty?

No. Farol is its own native Mac app that embeds libghostty, the engine behind Ghostty. You get the same rendering and speed, and Farol reads your Ghostty config and themes.

How do I know when an agent needs me?

The session's dot turns yellow, macOS sends a notification and the Dock icon counts the sessions that are waiting. The menu bar item or the notch panel shows the same from any app.

Can I answer my agents from my phone?

Yes, with Farol Remote. Farol for iPhone lists your sessions, notifies you when one waits, and lets you answer Claude Code or Codex with a tap. It's free, end-to-end encrypted and on the App Store.

Can I talk to my agents by voice?

You can dictate your prompts with Farol Voice, our free app that runs on your Mac and types into any app, including Farol. Controlling Farol by voice is coming next.

Is Farol free?

Yes. Farol is open source under the MIT license. It needs a Mac with Apple silicon and macOS 14 or later.

Farol is free and open source

Apple silicon, macOS 14+.

Download for Mac GitHub