Open source · GPL-3.0

Bring your own CLI
to a focused coding workspace.

Run any AI coding agent — Claude Code, Codex, Gemini, Aider, Goose — side-by-side with a live browser and your project files. Point at what needs fixing, not paste screenshots.

Download for Windows View on GitHub →

macOS & Linux builds coming soon · v0.1.3

Features

A focused shell for AI coding agents

BYOCLI doesn't pick your CLI for you. It gives every agent a persistent home, a live view of what it's building, and a way to talk about pixels without pasting.

Any CLI, any agent

Claude Code, Codex, Gemini, Aider, Goose, OpenCode — or your own. Profiles auto-detect when you launch an agent, and BYOCLI restores native session history via --continue and --resume.

Point, don't paste

The browser split isn't just a preview. Click Annotate, highlight any element, and BYOCLI pastes a structured instruction — selector, XPath, bounds, nearby text — straight into your agent.

Live browser, native

A real OS webview (WebView2 / WKWebView / WebKitGTK) running beside your terminals — not a separate window. Multi-tab, navigation, DevTools, media muted by default.

Workspace-scoped

Each workspace is a real folder with its own terminals, browser tabs, and history. Switch projects without losing your place. State persists across restarts in SQLite.

Schedule the boring stuff

Run commands on interval, daily, weekly, or cron. Overlap policies, timeouts, retries, and full output capture. Run in a workspace or a file-free temp sandbox.

Open source, GPL-3.0

Free to use and modify — and anything built on BYOCLI must stay open too. No vendor lock-in, no telemetry, no account. Just a focused desktop tool.

How it works

From clone to fix in three steps

  1. 01

    Pick a CLI

    Choose a profile — Claude Code, Codex, Gemini, Aider, or your own command. BYOCLI launches it in a real PTY with native session restore.

    > claude
✓ Restored session · 3 files in context
  2. 02

    Open a workspace

    BYOCLI scopes every terminal, browser tab, and automation to the folder you pick. Switch projects instantly; state persists in SQLite.

    workspaces/
  ├── byocli-app      (active)
  └── personal-site
  3. 03

    Point at what to fix

    Click Annotate in the browser split, highlight the element, describe the change. BYOCLI sends a structured instruction to your agent — no more screenshots.

    1. Increase this heading's size
   CSS: main > h1.hero-title
   XPath: /html/body/main/h1[1]
Install

Get BYOCLI

Grab the latest Windows installer, or build from source on any platform. Tauri 2 supports Windows, macOS, and Linux.

Windows Recommended

Download the NSIS installer and run it. Installs to your user profile — no admin required.

Download latest release
From source

Clone the repo and build for Windows, macOS, or Linux.

git clone github.com/be9hop/byocli
cd byocli
npm install
npm run tauri dev

Pre-built macOS and Linux binaries are on the roadmap. See the build guide for platform prerequisites.