Spaces
Open source · Claude Code · Codex · Gemini CLI

Your coding agents.
Everywhere you are.

Spaces runs your agents in persistent workspaces on your machine or a server, shows which one needs you, and lets you pick them up from your terminal, your browser or your phone.

$ npm install -g @jlongo78/agent-spaces
spaces
The Spaces terminal client: Claude Code and Codex working in two spaces, split side by side. Codex stops to ask for approval and gets it from the menu, then the Files tab, a detach and a reattach.

Recorded live: Claude Code and Codex building a small app. Only the prompts are scripted.

The same live agents, wherever you are

Your agents run on the server whether or not anything is watching. These are three views of the very same sessions, not copies.

spaces
Claude Code and Codex side by side in the terminal client, both working

Every agent at a glance

  • A sidebar of your spaces and every agent in them: blocked, working, done or idle.
  • Tabs, a split view to watch two at once, and ctrl+k for everything else.
  • A Files tab with a live preview, an editor, and drag-and-drop upload.
$ spaces
localhost
The Spaces web app with Claude Code finished and Codex waiting for approval

A big-screen view, and your history

  • The same spaces as a grid of terminals: start something in the terminal, finish it here.
  • Every past Claude Code, Codex, Gemini CLI and Aider session, searchable, ready to resume.
  • Token use, an activity heatmap and cost estimates from your own history.
$ spaces open
Claude Code and Codex in the Spaces phone layout, Codex asking to run the tests

Check in from the couch

  • The same sessions in a touch layout: see who is blocked, read what they did.
  • Quick keys for the prompts agents ask: tap y to approve.
  • Voice input for the next prompt.
$ spaces open --remote you@box

From a fresh server to working agents, in one command

Run your agents on a box that never sleeps, and reach them from your laptop over the SSH you already have.

spaces --remote demo@devbox
  1. It installs Spaces there. No Spaces on the server yet, or an older one? spaces --remote offers to install or update it first.
  2. It sets up your key. Asked for a password? It offers to set up SSH key sign-in, so you are never asked again.
  3. It connects, and stays out of the way. Detach and the agents keep running; spaces open --remote brings up the browser.

Built for running several agents at once

Knows who needs you

Blocked, working, done or idle for every agent, toasts when one stops, and counts in the status bar.

Agents that talk

A message bus per space: agents post what they finished, ask each other, and can ask you to approve.

Every session, searchable

Past Claude Code, Codex, Gemini CLI and Aider sessions indexed locally, with full-text search and resume.

Usage at a glance

Token use by model, an activity heatmap and cost estimates, from your own history.

Files in the terminal

Browse with a live preview, edit, upload by dragging, download whole folders, on any machine.

Private by default

Loopback only, owner-only sign-in, no telemetry. Remote access rides your SSH.

Works withClaude CodeCodex CLIGemini CLIAiderForgeCodePiAny shellAny command
See every feature

Questions people ask

How is this different from tmux?

tmux keeps terminals alive. Spaces does too, and also knows what each agent is doing, tells you when one needs you, shows the same sessions in a browser and on a phone, and indexes your agent history.

Do I need a server?

No. spaces runs on your own machine. A server is for when you want agents to keep working while your laptop sleeps; spaces --remote you@box sets one up in one command.

Is it safe to run on a server?

Nothing is exposed: the server listens on loopback and answers only the account that owns it. You reach it through an SSH tunnel, so the only way in is your SSH login. Agents run as you, without a sandbox.

Does it send my code or prompts anywhere?

No. There is no telemetry. It checks npm for updates and fetches agent-detection rules from this site; the agents talk to their own vendors as usual.

Which platforms?

Windows, macOS and Linux, on Node.js 20.9 or newer. The terminal client ships prebuilt for all three.

What does it cost?

Nothing. Spaces is open source under the Apache-2.0 license. You bring your own agent subscriptions.

Up and running in a minute

1

Install

Node.js 20.9 or newer. Windows, macOS and Linux.

npm install -g @jlongo78/agent-spaces
2

Start

Starts the server in the background and opens the terminal client.

spaces
3

Or on a server

Installs Spaces there if it is missing, and connects.

spaces --remote you@box

On Linux the terminal library compiles during install, so you need python3, make and a C++ compiler (sudo apt install build-essential python3). Full instructions are in the README.

Latest from the blog