https://github.com/aetherci-hq/sorcerer
Multi-session workbench for your coding agents. Not an IDE.
https://github.com/aetherci-hq/sorcerer
agentic-ai ai-agents claude-code cli codex cursor desktop-app electron git-worktree ide llm opencode orchestration parallel terminal tui vibe-coding vibecoding worktrees
Last synced: 16 days ago
JSON representation
Multi-session workbench for your coding agents. Not an IDE.
- Host: GitHub
- URL: https://github.com/aetherci-hq/sorcerer
- Owner: aetherci-hq
- License: apache-2.0
- Created: 2026-02-10T01:01:57.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-29T00:08:48.000Z (21 days ago)
- Last Synced: 2026-04-29T00:26:03.889Z (21 days ago)
- Topics: agentic-ai, ai-agents, claude-code, cli, codex, cursor, desktop-app, electron, git-worktree, ide, llm, opencode, orchestration, parallel, terminal, tui, vibe-coding, vibecoding, worktrees
- Language: TypeScript
- Homepage: https://sorcerer.sh/
- Size: 2.76 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Sorcerer
The desktop workbench for AI command-line coding tools. Not an IDE — a mission control for the agents that do the work.
## Download
Grab the latest release for your platform:
**[Download for Windows, macOS, and Linux](https://github.com/aetherci-hq/sorcerer/releases/latest)**
Requires a supported AI CLI tool installed and available on `PATH`, such as [Claude Code](https://docs.anthropic.com/en/docs/claude-code), Gemini CLI, or Codex CLI.
> **Authentication note:** Sorcerer runs multiple concurrent agent sessions. Consumer subscription accounts (Claude.ai Pro, Gemini Advanced, etc.) are not designed for this usage pattern — you should authenticate each CLI tool with an **API key** from the respective provider.
> **Windows note:** The installer is not yet code-signed. SmartScreen may show "Windows protected your PC" — click **More info** → **Run anyway** to proceed. macOS users may need to right-click → Open on first launch.
## Features
- **Multi-session management** — Run multiple AI agent sessions side-by-side with persistent terminals
- **Project & worktree isolation** — Automatically create git worktrees so each session works in its own branch
- **Split view** — View and interact with multiple sessions simultaneously
- **Team awareness** — Monitor provider-specific integrations such as Claude Code teams and tasks
- **Standalone sessions** — Launch quick agent sessions without a project
- **Session recovery** — Resume previous sessions, detect orphaned worktrees, recover from crashes
- **Quick Notes** — Per-session scratchpad that persists across restarts
- **Remote access** — Built-in HTTP + WebSocket server with token auth for browser-based access
- **Cross-platform** — Windows, macOS, and Linux
## Permissions
Sorcerer exposes a provider-agnostic unattended mode toggle. When enabled, it maps to the closest equivalent supported by the selected provider — for example Claude Code uses `--dangerously-skip-permissions`, Gemini CLI uses `--yolo`, and Codex CLI uses `--dangerously-bypass-approvals-and-sandbox`. This can be toggled per session and per agent. Review each provider's documentation before enabling it.
## Terms of Service & Licensing
Sorcerer is an independent orchestration workbench. It operates as a wrapper around existing CLI-based AI agents such as Claude Code, Gemini CLI, and Codex CLI.
- **Independent Tool**: Sorcerer is not affiliated with, endorsed by, or sponsored by Anthropic, Google, OpenAI, or any other AI service provider.
- **API Keys Required**: Sorcerer's multi-session model is designed for API key usage. Consumer subscription accounts are not compatible with concurrent session workflows. Users should authenticate each CLI tool with an API key from the respective provider.
- **No Circumvention**: Sorcerer does not bypass, modify, or multiplex user authentication or subscriptions. It relies entirely on the user's own local installation and valid authentication for these CLI tools.
- **Compliance**: Users are responsible for ensuring their use of underlying CLI tools through Sorcerer complies with the respective providers' Terms of Service. Sorcerer interacts with these tools via standard terminal interfaces (PTY) and does not modify their binary code or internal logic.
## How it works
Sorcerer wraps AI CLI sessions in native pseudo-terminals (`node-pty` + `xterm.js`), manages git worktrees for branch isolation, and integrates with provider-specific capabilities where available, such as Claude team data in `~/.claude/teams/`. All session data is stored locally in SQLite.
## Built with
Electron, React 19, TypeScript, electron-vite, xterm.js, node-pty, sql.js, Zustand, chokidar, simple-git
## Project Charter
Sorcerer is a mission control for AI-first development. It is explicitly not an IDE; it is the orchestration layer above, managing the agents that do the work. While editors focus on typing code, Sorcerer focuses on directing it—handling concurrent sessions, git worktrees, and cross-project context so you can scale your AI workforce.
We believe in staying out of the IDE's lane. If a feature doesn't help orchestrate coding agents, it doesn't belong here. Sorcerer is designed for developers whose primary workflow *is* the AI, providing a professional workbench for directing work rather than manually editing files.
## Contributing
We welcome your help in making Sorcerer better! Please read our [Contributing Guidelines](CONTRIBUTING.md) to get started.
## License
[Apache-2.0](LICENSE) — Built by [AetherCI](https://aetherci.com)