cones: A terminal workspace for coding agents.

A terminal workspace for coding agents. Peek into sessions, return to past work, and start work in another project without leaving the dashboard.

cones brings Claude Code, Codex, pi and OpenCode into one workspace while keeping their native terminal interfaces. Your conversations stay with each harness, so you can use its CLI directly whenever you prefer.

Install · Quick start · Documentation

Work from one place

	In cones
Live sessions	See running agents grouped by project, including sessions started outside cones.
Previews	Peek into supported live sessions and open their native interface when you want to respond.
History	Browse past conversations, read previews and resume a session.
Projects	Add an existing folder and start an agent there from the dashboard.
Settings	Adjust the layout, visible columns and model defaults in place.
Scheduled work	Create recurring Claude Code jobs and review their output and cost.

Each harness keeps its own tools and permissions. Available previews and controls follow its native capabilities.

Models, harnesses and interfaces

Tool	Choice it preserves
OpenCode / pi	Choose your model and provider while keeping one harness.
T3 Code	Choose your harness while keeping T3's common interface.
cones	Keep your harnesses' native terminal interfaces while adding a shared workspace.

Install

Requires macOS. Install and configure the harnesses you want to use:

Harness	Requirement
Claude Code	2.1 or later, with background sessions (`--bg` and `attach`).
Codex	0.154 or later.
pi	`pi` available in your terminal.
OpenCode	Native CLI with SQLite session storage. See harness support.

Install cones with Homebrew:

brew tap YuvalSarel1/cones https://github.com/YuvalSarel1/cones
brew trust YuvalSarel1/cones
brew install cones

Or build it with Cargo:

cargo install --git https://github.com/YuvalSarel1/cones

From a checkout of this repository, cargo install --path . does the same.

Quick start

Open the workspace. Existing sessions appear automatically; no configuration file is needed.

cones

To start work in a project:

Choose folder in the menu and enter an existing project directory.
Use Shift+Tab to choose Claude Code, Codex, pi or OpenCode.
Type an instruction and press Enter.

Open a session with Enter; Ctrl+Z returns to the list. Press Ctrl+H to browse history, select a conversation to preview it, and press Enter to resume.

The config menu lets you change the layout, columns and model defaults. To open a shell in the selected project, choose terminal with Shift+Tab and press Enter.

See the dashboard guide for the full controls.

Schedule work

Open jobs in the menu, choose new job, and enter the task, folder and schedule. Saving installs the schedule. Select a job and press Enter to run it immediately.

Scheduled jobs currently use Claude Code. The job form also exposes timeouts and write permissions. For file-based setup, start with jobs.example.yaml and the configuration guide.

Run a task from the shell

cones run --prompt "Read this repo and summarize its TODOs."

This runs a supervised Claude Code task in the current directory. See one-off tasks for policy selection.

Documentation

Guide	Contents
Dashboard	Controls and interactions, in screen order.
Configuration and runs	All `jobs.yaml` fields, scheduling and run lifecycle.
Commands	CLI flags, one-off tasks and diagnostics.
Harness support	Native sources, reports and capabilities.
Harness definitions	The built-in integration schema.