devias CLI - Devias

devias is a command-line tool for working with modules. It reads a manifest, asks the server what would change, and applies it. It never uses a browser session: every command signs in with an API key.

Run it

Inside the repository, run the entry point with Node. There is nothing to build.

node packages/cli/bin/devias.js plan -w <workspaceId> -m ./src/manifest/index.ts

If @devias/cli is a dependency of your project, the same command is available as plain devias. The rest of these pages write devias.

Options every command takes

Flag	Environment variable	Meaning
`-m, --manifest <path>`		Your manifest file: `.ts`, `.js` or `.json`. It must export `manifest`, or a default export.
`-w, --workspace <id>`		The workspace id. Copy it from Settings → General.
`-u, --url <url>`	`DEVIAS_URL`	The server. Defaults to `http://localhost:3000`.
`-k, --api-key <key>`	`DEVIAS_API_KEY`	The API key to use.

The key must be allowed to manage modules. A key made in Settings → API keys can only read records, so create the key through the API with permissions: { "module": ["manage"] }.

Commands

Command	Purpose
`devias plan`	Show what would change.
`devias apply`	Apply the change.
`devias dev`	Re-apply on every save.
`devias uninstall`	Remove a module.
`devias id`	Generate new ids.

Plan and apply: how plans work.
Create a first module: a procedure that uses the CLI.