Home
A workspace for everything you do in a terminal — terminals, browsers, SSH+tmux sessions, AI agents — laid out the way you think.
ClusterSpace is a desktop app (Electron + React + TypeScript) that turns "I have nine terminals open across four monitors" into a single tiled workspace with persistent sessions, drag-to-reorder panes, embedded browsers, and an optional AI co-pilot that can read from and write to any pane — or pursue a goal autonomously until it's verified done.
| If you are… | Read this |
|---|---|
| Brand new — want to try it | Installation → Quick-Start |
| Looking for a hotkey | Keyboard-Shortcuts |
| Setting up SSH + tmux | SSH-and-tmux |
| Configuring the AI co-pilot | AI-Providers → AI-Overview |
| Wanting full autonomy | Goal-Runner-Overview |
| Extending the app | Tool-Registry → Plugin-Authoring |
| Stuck on something | Troubleshooting · FAQ |
The day-to-day surface area: workspaces, panes, terminals, browsers, the command palette, broadcast mode.
- Workspaces-and-Layout · Terminal-Panes · Per-Pane-Tabs
- SSH-and-tmux · Browser-Panes · Saved-Logins
- Command-Palette · Broadcast-Mode · Settings-and-Configuration
Optional but central. Provider-agnostic (Claude, OpenAI, Ollama, LM Studio), ~52 tools spanning terminal control, browser automation, agent orchestration, vision verification.
- AI-Overview · AI-Providers · AI-Chat-Panel · AI-Tools-Reference
- Personas · Skills · Task-Templates
- Agent-Orchestration · Fleet-Dashboard
The headline autonomy feature: give a pane a goal, walk away, come back when it's verified done.
- Goal-Runner-Overview · Starting-a-Goal · Success-Criteria
- Goal-Policy-and-Risk-Levels · Critic-and-Replan · Vision-Verification
- Goal-Dashboard
For people writing personas, authoring task templates, building custom tools, or hacking on the app itself.
- Architecture-Overview · IPC-Channels-Reference
- Tool-Registry · Plugin-Authoring
- Writing-Personas · Writing-Task-Templates · Browser-Recipe-System
- Goal-Runner-Internals · Data-Storage-and-Migration · Contributing
- Troubleshooting · FAQ · Glossary · Changelog · Roadmap
| Most terminal apps | ClusterSpace | |
|---|---|---|
| Tabs / splits | ✔ | ✔ |
| Configurable grid | ✔ (some) | ✔ — drag-resize, drag-swap |
| Multi-workspace | ✔ (some) | ✔ — independent layouts, persistent |
| Embedded browser | ✘ | ✔ — full Chromium, tabs, saved logins |
| SSH wrapped in tmux automatically | ✘ | ✔ — per-pane session names |
| AI can read/write any pane | ✘ | ✔ — 30+ tools, per-pane agent state |
| AI can pursue a goal autonomously | ✘ | ✔ — policy-gated, verified, critic-supervised |
| Vision verification of browser actions | ✘ | ✔ — strict YES/NO vision judge |
- GitHub repo · Releases · Issues
- MIT licensed. PRs welcome — see Contributing.