@ctrl-spc/cs
v0.6.0
Published
CTRL+SPC — minimal, reliable per-machine agent presence. Sign-in, auto-start, agent detection, heartbeat presence, and ping acknowledgement.
Readme
@ctrl-spc/cs
The cs command keeps your computer online for CTRL+SPC so your coding
agents can be reached, and opens the Companion — a small local app for
signing in and attaching your codebases to your projects.
Install
npm i -g @ctrl-spc/cs && csThat's it. The && cs opens your browser straight to sign-in — you barely touch
the terminal:
Welcome to CTRL+SPC — opening your browser to sign in…In the browser you'll:
- Sign in (or sign up on the web).
- Attach a codebase — point a project at a folder on this computer that has a git remote.
- Open the web app — create work items and hand them to an agent.
Your folder paths stay on this computer; only path-free identifiers (a git remote URL) are shared.
Stay online
cs autostart onComes online automatically at login, with no window. Turn it off with
cs autostart off.
Commands
cs Open the Companion app (the front door)
cs open Open the Companion app in your browser
cs login Sign in from the terminal and link this computer
cs start Come online now, no window (used by auto-start)
cs status Show sign-in state, computer, and detected agents
cs autostart on Come online automatically at login
cs autostart off Stop coming online at login
cs logout Sign this computer out
cs help Show this helpRequirements
- Node.js >= 22.
Not sure what a piece does? Open the Companion (cs) and click How it works.
