Clayo

Every Claude Code and Codex session in one Windows window, plus an island that tells you which one needs you.

Why

You run four or five coding agent sessions at once, Claude Code or Codex, each in its own terminal. One is waiting for a permission, one finished ten minutes ago, and you're in the browser. Clayo puts them all in one window and tells you when one needs you, without you switching windows.

What you get

• The real Claude Code and Codex. Each pane is a real terminal (ConPTY + xterm.js) running the claude or codex you already use: slash commands, permission prompts, plan mode, your status line.

• Both side by side, or just one. Use Claude Code, Codex or both; with both, each session in the sidebar is tagged CC or CX.

• Set up in one screen. The first time it starts, Clayo finds your agents, installs or signs in to the one you're missing, and turns on start at login and clayo in Explorer.

• Sessions on the left, grouped by folder. Search, rename (F2), resume with a click.

• Branch from here. Fork a conversation into a new session. The branch sits under its parent; the original stays as it was.

• The island. A small pill drops from the top of the screen when a session needs you or has finished, even while you're in another app. It never takes focus. Click it to jump to that session.

  

• Drop a file or folder on the island and it opens in Clayo.

• Send a screenshot to a session. Take one with Win+Shift+S, press Ctrl+Alt+S, and the island asks which session it's for. The image lands in that session's prompt, ready for your question. Works with Claude Code and Codex. Settings › Island can also offer it after every screenshot.

• Status at a glance. Each pane's header shows model, branch and diff, context and effort. The sidebar footer shows your 5-hour and 7-day limits, drawn as Numbers, Bars, Rings or Chips, and the island warns you once when you get near one.

• Type clayo in any Explorer address bar to open a session in that folder.

• Stays out of the way. Start at login, hidden until the island has something to say. Closing the window keeps sessions running.

• Updates itself. When a new release is out, one click updates Clayo and opens it again, once no session is working.

Install

Open PowerShell, paste this and press Enter:

irm https://raw.githubusercontent.com/YogiOnCode/Clayo/main/scripts/install.ps1 | iex

It runs scripts/install.ps1: it downloads the latest release, checks it against the release's SHA-256, puts it in %LOCALAPPDATA%\Programs\Clayo and starts it. Every release zip is built on GitHub Actions; to check one yourself, run gh attestation verify clayo-<version>-win-x64.zip --repo YogiOnCode/Clayo.

Or by hand

1. Download clayo-<version>-win-x64.zip from the latest release.
2. Unzip it into %LOCALAPPDATA%\Programs (paste that into Explorer's address bar), so you have %LOCALAPPDATA%\Programs\Clayo\clayo.exe. Keep it there: start at login and clayo in Explorer point at this folder.
3. Run clayo.exe. Clayo isn't signed yet, so Windows may say "Windows protected your PC": click More info, then Run anyway.

You need Windows 10 or 11, 64-bit, and nothing else first: .NET comes inside the zip, and the WebView2 runtime is already on Windows 11 and on most Windows 10 PCs.

First run

The setup window looks for Claude Code and Codex. You need at least one.

• Missing one? Install runs its own installer in a PowerShell window you can watch (Codex needs Node.js first). Sign in does the same for signing in, and Locate… points Clayo at an install in an unusual folder.
• Choose which ones to use and which one New session starts.
• Keep Start Clayo when I sign in and Add clayo to my PATH ticked, then press Open Clayo.

Settings › Agents brings the setup window back. What works with each agent, and how to install them by hand: docs/AGENTS.md.

Updating

When a new release is out, an Update to … button shows above New session. Press it: Clayo closes, updates and opens again. A session that is working or asking you something is never cut off: the update waits until none is. Idle sessions close; resume them from the sidebar. Clayo asks GitHub for the latest release when it starts and every 12 hours after.

Or quit Clayo from the gear menu and run the install command again. Either way your settings are kept.

Uninstalling

1. In Settings › Agents, untick Start Clayo when I sign in and Add clayo to my PATH, and press Open Clayo.
2. Quit Clayo from the gear menu.
3. Delete %LOCALAPPDATA%\Programs\Clayo, and %LOCALAPPDATA%\Clayo too if you want your settings gone. Your Claude Code and Codex sessions aren't touched.

Build from source

You need the .NET 8 SDK.

git clone https://github.com/YogiOnCode/Clayo.git
cd Clayo
dotnet publish src/Clayo -c Release -r win-x64 --self-contained false -o $env:LOCALAPPDATA\Programs\Clayo

Then run clayo.exe from there; the setup window takes care of PATH. Keep the Assets\ folder next to clayo.exe, the terminal pane loads from it. .\scripts\publish.ps1 builds the release zip instead. The self-checks in checks/ need the .NET 10 SDK (they're file-based apps); the app itself builds with .NET 8.

Use

• New session: the button at the bottom of the sidebar, or clayo in a folder.
• Branch: open a session, then Branch from here in its header.
• Settings: the gear menu, or Ctrl+,. Agents there reopens the setup window.
• Quit: Quit Clayo in the gear menu or the island's menu. The window's close button only hides it.

More in the wiki.

Docs

Claude Code and Codex	What works with each, installing them by hand
Install	Download, first run, updating, uninstalling
Sessions and Branching	What each button runs
The Island	Notices, peek, drop to open
Status Bar and Limits	Pane header, limits, themes
Settings	Every option
Troubleshooting	When something looks wrong
How It Works	The code, module by module
Roadmap	What's next

Contributing

Issues and pull requests are welcome. Open an issue before a big change so we can agree on the approach first. Pull requests to main need one review and are squash-merged. See Contributing for building and running the checks. Found a security issue? Report it privately from the Security tab, not in an issue.

Notes

Not affiliated with Anthropic or OpenAI. Clayo reads ~/.claude and ~/.codex and never writes to either. Its only network call of its own is asking GitHub for the latest release, at start and every 12 hours. Where it does keep files is listed in How It Works.

MIT licensed, see LICENSE. Bundles xterm.js and its fit and WebGL addons (MIT, see src/Clayo/Assets/xterm/LICENSE.xterm).