Soloe

Soloe

A local-first agent development environment for solo developers who use CLI agents.

Soloe keeps projects, worktrees, terminals, plans, and code review in one place. It runs the installed Claude Code, Codex CLI, and Cursor Agent CLI in interactive mode, with their normal authentication and terminal behavior intact.

[](https://github.com/mheraskin/soloe/actions/workflows/ci.yml) [](./LICENSE)

**Public source preview.** The repository is public, but there is no binary release yet. Run Soloe from source and expect breaking changes. Soloe has no hosted cloud, analytics, or telemetry.

[Run from source](#run-from-source) · [Roadmap](./ROADMAP.md) · [Security](./SECURITY.md) · [Privacy](./PRIVACY.md) · [Contributing](./CONTRIBUTING.md)

Why I built it

I started Soloe on Windows with my development environment inside WSL. The agent tools I could find treated that setup as an edge case, and stitching together terminals, worktrees, plans, and review took more effort than the work itself.

My normal setup has a few long-running feature worktrees. Each may have Claude Code, Codex, or Cursor running in a real terminal. I want to see what is active, return to a session days later, review the feature across its full commit history, and send a precise comment back to the agent. Soloe grew around that loop.

Soloe is named for this way of working. Agents help me take on more, but I still decide what to build and what is safe to ship.

What works today

• Interactive CLI agents. Soloe runs installed claude, codex, and Cursor agent binaries on macOS, Linux, native Windows, or inside WSL.
• Project and worktree organization. Sessions stay attached to the checkout where their work belongs. A logical workspace can have independent checkouts on more tha