Skip to content

TeckniX/space-agent

 
 

Repository files navigation

Space Agent banner

Try Live Now!

Run local App Host yourself

Deploy on Railway

Created by Agent Zero.

Discord X YouTube Ask DeepWiki

Watch Space Agent on YouTube

Why Space Agent Is Different

The agent reshapes the interface — Ask for a page, tool, widget, or workflow and the agent can build it straight into the running workspace while you work. Endless possibilities — The agent is not trapped inside a fixed product surface. It can develop the capabilities it needs from within the system itself and keep extending the Space toward whatever the user can imagine.
Space Agent app icon The agent lives in the frontend runtime — Space Agent runs in the browser layer itself, whether you open it in a tab or through the desktop app, so the agent can work directly with the same framework, modules, spaces, and UI it is reshaping.
Text-based agent — New capabilities can live in simple SKILL.md files that the agent can write and extend itself in plain text. Token-efficient execution — No bulky tool-call JSON. When action is needed, the agent can stay in plain text and plain JavaScript inside the same message.
Puzzle-piece modularity — The core stays small. Most of Space Agent is made of modular pieces that can be added, removed, or swapped cleanly instead of being welded into one rigid app. Space Agent helmet
Personal to hierarchical — Use Space Agent as a completely personal assistant, or organize it into a hierarchical system of users and groups as the scope grows. Per-user work, group sharing — Users can build in their own layer without affecting anyone else, then groups can share tools, workflows, and behavior across teams when they are ready.
Space Agent astronaut Persistent admin and time travel — When something breaks, admin mode gives you a stable control plane, and Git-backed history lets you roll back user or group changes without taking everyone down with you.

Try it in 30 seconds

Try our demo server with guest account.

Run it yourself

The desktop app

Grab the latest build from GitHub Releases. It runs everything as one app. No terminal required.

A real server, for you or your team

git clone https://github.com/agent0ai/space-agent.git
cd space-agent
npm install

# create yourself an admin
node space user create admin --password "change-me-now" --full-name "Admin" --groups _admin

# start the server
node space serve

For development

npm run dev # server with auto-reload

Open the checked-in VS Code launch entry Dev Server (npm run dev) when you want breakpoints in server/ code. It launches the same watcher and auto-attaches to the spawned node space serve process across restarts.

For production

node space set CUSTOMWARE_PATH=/srv/space/customware
node space supervise HOST=0.0.0.0 PORT=3000 # zero downtime auto-update

Deploying to Railway

Railway can run Space Agent from this repo using the checked-in railway.toml: the service builds from the root Dockerfile, sets CUSTOMWARE_PATH to /data/customware, and expects a persistent volume at that path so user data survives redeploys (see the volumes entry under [service.experimental] in railway.toml).

  1. Create a Railway project and connect this repository (or push the image you build from the same Dockerfile).
  2. Attach storage so /data/customware is a mounted volume; without it, redeploys can wipe local state.
  3. Deploy; Railway injects PORT and the container listens on HOST=0.0.0.0.

Default login (Docker / Railway first boot): username admin, password change-me-now. The entrypoint creates this user only when the admin layer is missing on the volume (see docker-entrypoint.sh). Change the password immediately after first sign-in, or set SPACE_DOCKER_ADMIN_PASSWORD before the first boot if you want a different initial password.

Run node space help to see the full command surface and built-in help for each from commands/params.yaml.

AI-driven development and documentation

Space Agent is developed by AI agents, including its documentation.

The framework keeps a hierarchical AGENTS.md instruction system, plus skills and focused docs, so agents can understand ownership, architecture, workflows, and local implementation rules while they build and maintain the system autonomously.

DeepWiki covers the human-readable side of that same knowledge base. Together, this keeps the codebase and its documentation prepared for autonomous agent work, and helps the documentation keep up with the pace of AI-driven development instead of falling behind.

If you want the deep tour, start here:

Ask DeepWiki

About

The agent that re-shapes the Space

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • JavaScript 93.8%
  • HTML 3.6%
  • CSS 2.6%
  • Shell 0.0%
  • NSIS 0.0%
  • Just 0.0%