Quickstart

Install the CLI

Run the install script. It downloads the singulacomp binary for your OS.

curl -fsSL https://singulacomp.ai/install | bash

SingulaComp supports macOS and Linux. There is no Windows binary yet.

Sign in

singulacomp login

This opens your browser for sign-in. After you sign in, singulacomp login picks your account and a default project for you.

Create or clone a project

A new account has no projects yet, so singulacomp login has none to pick. Run singulacomp init with a name to create your first project. This scaffolds a project directory on your machine.

singulacomp init my-app
cd my-app
singulacomp ship

singulacomp ship creates the project in SingulaComp Cloud on its first run, then pushes your code. Run singulacomp ship again any time to sync local changes.

To work on a project that already exists in SingulaComp Cloud, clone it instead:

singulacomp projects clone <project-id>

Find <project-id> with singulacomp projects ls.

Run a session

singulacomp sessions new --prompt "Build the login page"

This starts a session. The agent works in its own sandbox, on its own branch, so your project is not touched yet.

Attach to the session to watch progress and reply:

singulacomp sessions chat

Review and merge the change request

When the agent finishes, it opens a change request with a summary and the exact diff.

singulacomp cr ls

This lists the open CRs in your project. Review the one the agent opened, then merge it to land the work on your default branch:

singulacomp cr merge 1

Replace 1 with the CR number from singulacomp cr ls. Nothing reaches your project's default branch until you merge.