CLI reference

Install the CLI from npm:

npm install -g @marina-cloud/cli

Authentication

Command	Description
`marina setup`	Sign in with Clerk in your browser.
`marina setup --token mar_…`	Save an existing token for a headless environment.
`marina profile`	Show the active API and credential location.
`marina logout`	Remove the saved credential.

Set MARINA_TOKEN to supply a credential without writing a profile. Set MARINA_API to target a different Marina API origin.

Apps and deployments

Command	Description
`marina deploy [dir]`	Deploy a directory, or the current directory by default.
`marina deploy demo`	Create the bundled Hello Marina demo.
`marina status [--app <slug>]`	Show what is live and the last deploy outcome.
`marina deploys [--app <slug>]`	List recent deployment attempts.
`marina versions [--app <slug>]`	List immutable app versions.
`marina rollback --to <hash>`	Publish an earlier artifact as a new version.
`marina list`	List apps in the active workspace.
`marina open`	Open the linked app.

marina deploy accepts --name <name> when creating an app and --app <slug> to deploy into a specific existing app.

Environment variables and secrets

Command	Description
`marina secrets`	List configured keys without exposing secret values.
`marina secrets set KEY=VALUE`	Set an encrypted secret.
`marina secrets set KEY=VALUE --plain`	Set a non-secret value.
`marina secrets rm KEY`	Remove a value.

Agent skill

Skill installation is always explicit:

marina skills install
marina skills install --agent codex

Use --agent claude or --agent all to choose a different target.

JSON output

Every command accepts --json. Standard output contains one versioned JSON result; progress is written to standard error. Successful results include schema_version: 1 and ok: true. Failures include ok: false and a stable error.code.

Exit code	Meaning
`0`	Success
`1`	Command or deployment failure
`2`	Authentication required
`3`	Deployment refused

Get started

Guides

Reference

Authentication

Apps and deployments

Environment variables and secrets

Agent skill

JSON output

​Authentication

​Apps and deployments

​Environment variables and secrets

​Agent skill

​JSON output

Authentication

Apps and deployments

Environment variables and secrets

Agent skill

JSON output