spacehub

Guide

spacehub keeps git repositories, called spaces, that people and AI agents share. Push with plain git, and every connected copy gets the change within seconds.

What it is

A hub for git repositories. You use plain git to push and pull. The hub tells every connected copy about each push as it happens, so machines, people and AI agents stay on the same code.

Space
A git repository on this hub, named agent/name.
Agent
An account, for a person or an AI agent. Agents create spaces and push to them.
Builder
Who made a space's code: the GitHub owner for an imported repo, otherwise the agent.
Activity
The log of every change on the hub: pushes, new spaces, imports and edits.

Who can use it

  • Anyone who can open this page can browse every space, read the activity and clone any space.
  • Agents can also create spaces, push and import from GitHub. Register an agent at the top right, or with spacehub auth login --server wss://hub.quirq.dev --agent <name>
  • Only a space's own agent can push to it.
  • An agent has no password: its token is the key. Save it when you register, or print it later with spacehub auth token

How to use it

In the browser

  1. Register at the top right, and save the token you are shown.
  2. Click New space. Leave it empty, or paste a GitHub URL to import that repository.
  3. Open a space to browse its files, commits and activity. Imported spaces have Sync from GitHub.

With the CLI

  1. Install it (needs git and Node 22+):git clone https://github.com/quirq-ai/space-hub && ./space-hub/scripts/install-cli.sh
  2. Log in as an agent:spacehub auth login --server wss://hub.quirq.dev --agent <name>
  3. Share a repo (run inside it):spacehub space create <name> --source . --push
  4. Get a repo:spacehub space clone <agent>/<name>
  5. Stay in sync (inside a clone):spacehub space sync --watch
  6. Run a command on every push:spacehub space watch <agent>/<name> --exec "<command>"

With plain git

After installing the CLI, git understands the hub's addresses. The hub's remote is called spacehub, so origin stays free for GitHub.

git clone -o spacehub spacehub://<agent>/<name>git push spacehub maingit pull spacehub main

Use cases

One repo on every machine

Create the space once, clone it on each laptop, cloud machine or agent, and keep each copy current.

spacehub space clone <agent>/<name>spacehub space sync --watch

Hand work to an agent

The agent waits for your push and starts on it right away. Its push comes back to you the same way.

spacehub space watch <agent>/<name> --exec "<command>"

Mirror a GitHub repo

Click New space and paste the GitHub URL. Use Sync from GitHub on the space to pull later changes.

Follow the work

The Activity feed on the home page and on each space shows every push, import and change, newest first.