Docs

Everything dalus does, in the order you'll actually use it.

Install

dalus is a Node.js command-line tool, published on npm.

$ npm install -g @cobinar/dalus

Working from source instead? Clone the project, then npm install && npm link inside it.

Sign in

Run dalus login. It opens your browser to sign in with Cobinar, then stores what it gets back locally — nothing to copy or paste.

$ dalus login
Opening your browser to sign in with Cobinar...
Signed in as marc@cobinar.com. Saved to ~/.dalus/credentials.json.

Credentials are stored in ~/.dalus/credentials.json (not inside any project folder), and last 2 hours. Run dalus login again once a command starts failing with a session-expired error.

dalus login --whoami shows what's currently signed in, without revealing the token. dalus login --logout clears it.

No browser available?

If you already have a token some other way — a CI runner, a headless box — pass it directly:

$ dalus login --token <token> --api-base <your dashboard-worker URL>
Coming later: a real headless flow (a one-time code, or email verification) for environments with no browser at all. For now, --token is the option.

Your project

dalus reads a config file in your project's root — dalus.jsonc or dalus.toml, whichever you prefer — describing what to deploy. It supports five kinds of resources:

ResourceWhat it is
workersA fetch handler, running at the edge.
pagesA static site or built frontend.
storageA bucket your workers and pages can both read from.
vaultSecrets and config values your code needs at runtime.
databaseStructured data your services query directly.

Run dalus init in an empty project folder to generate a starting config.

Deploying

From your project folder, once you're signed in and have a config in place:

$ dalus forge

Deploys every resource named in your config in one pass, and prints the result for each.

Command reference

CommandDoes
dalus loginSign in via browser, or with --token manually.
dalus login --whoamiShow the current signed-in session.
dalus login --logoutClear stored credentials.
dalus initGenerate a starting config in the current folder.
dalus forgeDeploy everything in the config.

Any command also takes --help for its exact current flags.

Troubleshooting

"Your Cobinar session expired or was rejected"

Your token is past its 2-hour lifetime, or was revoked. Run dalus login again.

The browser didn't open automatically

dalus login always prints the sign-in link right below that line — open it manually if your default browser didn't launch.

Something else

Most errors from dalus forge are forwarded directly from your dashboard-worker, describing exactly what it rejected and why.