---
title: Introduction
description: Fyolo is a native Mac app for your AI coding agents — run Claude Code, Codex, and the rest side by side, each in a real terminal, on this Mac or on a box you own.
---

Fyolo is a native Mac app that gives your AI coding agents a home. Instead of
juggling agents across scattered terminal tabs, you run them side by side —
each in a real terminal — and switch between them instantly. Everything runs on
hardware you own: this Mac, or a box you can `ssh` to.

## What Fyolo gives you

- **A real terminal per agent.** Claude Code, Codex, Amp, Droid, Cursor, Copilot,
  Antigravity, Crush, Cline and the rest each run in a genuine PTY — not a
  re-rendered chat log. What you’d see in iTerm is exactly what you see here.
- **A sidebar of sessions.** Every agent and shell is one click away. Statuses
  update live, so you can see which agent is working, which is idle, and which
  needs your attention.
- **Split panes.** Put an agent, a dev server, and a shell in the same window,
  arranged the way you think.
- **Any machine you own.** A workspace can live on a VPS or the Mac mini across
  the room. Fyolo copies one binary there over SSH and sets up the agents; the
  sessions run on that box and keep running whether or not you’re attached.
- **A built-in inspector.** Browse the working directory, edit files with syntax
  highlighting, read the git diff, and search across the project — all without
  leaving the window.
- **An orchestration API.** The `fyolo sessions` CLI lets one agent — or your
  scripts — spawn siblings, answer their prompts, and supervise the fleet over
  a local socket, with pinned JSON shapes and honest exit codes.
- **Your phone as a remote.** Pair the iPhone app once and check in on a running
  session from anywhere, over your own network or a tunnel you control.

## Local-first, always

Fyolo has no account and no sign-in. Your terminals, code and agent
conversations never pass through servers of ours — there are none in the
product’s data path. Reaching another machine goes through the system `ssh` and
your own `~/.ssh/config`; Fyolo provisions nothing and relays nothing. The
agents you run talk to their own providers under your own accounts, exactly as
they would from a plain terminal.

Fyolo is **free to use** — no account, no license keys, no payment backend.

## Pick your path

Most people arrive here for one of three reasons. Start where you actually are:

<Cards>
  <Card href="/docs/first-session" title="I just want to run an agent">
    Install, open a project, start Claude Code or Codex in a real terminal, and
    split the window. Ten minutes, no concepts required.
  </Card>
  <Card href="/docs/agents" title="I'm already running several at once">
    The part that pays off: live status per session, worktrees to keep two
    agents out of each other's files, and the sidebar as a fleet dashboard.
  </Card>
  <Card href="/docs/devices" title="My code lives on another box">
    A VPS, a Mac mini, a devbox. Fyolo copies one binary there over your own
    SSH config and the sessions run on that machine, attached or not.
  </Card>
</Cards>

## Or let an agent read the docs for you

You already have a coding agent. These docs are published in a form it can read
directly, so you can hand it the setup instead of doing it yourself:

```text
Read https://fyolo.sh/llms.txt and then help me set up Fyolo for my project.
```

Every page also answers with plain Markdown at its own URL, and
[llms-full.txt](https://fyolo.sh/llms-full.txt) is the whole set in one file —
so an agent can answer from the docs rather than improvising.

## Start here

<Cards>
  <Card href="/docs/installation" title="Installation">
    Download the Mac app and get it updating itself. No account required.
  </Card>
  <Card href="/docs/first-session" title="Your first session">
    Open a project, launch an agent in a real terminal, and split the window.
  </Card>
  <Card href="/docs/agents" title="Running multiple agents">
    Keep a fleet side by side and read each one’s live status at a glance.
  </Card>
  <Card href="/docs/devices" title="Devices">
    Put a workspace on another box and set up the session host there.
  </Card>
  <Card href="/docs/persistence" title="What survives">
    Close, quit, update, reboot — exactly what happens to a running agent.
  </Card>
  <Card href="/docs/session-control" title="Orchestration & the CLI">
    Let agents spawn, drive, and supervise each other with `fyolo sessions`.
  </Card>
  <Card href="/docs/iphone" title="The iOS app">
    Pair your phone and check in on a running agent from anywhere.
  </Card>
</Cards>