CLI Reference

The Maritime CLI lets you deploy and manage agents from your terminal.

Installation

npm install -g maritime-cli

Requires Node.js 18 or later.

Authentication

maritime login

Authenticate with your Maritime account. Opens your browser for login by default, or pass credentials directly for non-interactive use.

maritime login

# Non-interactive login:
maritime login -e user@example.com -p yourpassword

maritime signup

Create a new Maritime account. Prompts interactively for any fields not provided.

maritime signup -e user@example.com -p yourpassword -n "Jane Doe"

# Or just run and follow the prompts:
maritime signup

maritime logout

Log out and clear stored credentials.

maritime logout

maritime whoami

Show the currently authenticated user, including email and token expiration.

maritime whoami

Agent Management

maritime create

Create a new agent. Pass options inline or follow the interactive prompts.

maritime create -n my-agent -t crewai --tier smart

# With initial environment variables:
maritime create -n my-agent -t crewai -e OPENAI_API_KEY=sk-... -e MY_VAR=hello

maritime list

List all your agents with their status, framework, tier, and creation date. Alias: maritime ls

maritime list

# Output:
# NAME            STATUS     FRAMEWORK    TIER       CREATED
# support-bot     active     crewai       smart      2025-04-12
# data-pipeline   sleeping   langgraph    extended   2025-03-28
# code-reviewer   sleeping   openclaw     extended   2025-05-01

maritime deploy

Deploy an agent. Accepts an agent name or ID prefix.

maritime deploy my-agent

# Deploy from a GitHub repo:
maritime deploy my-agent --source github --repo https://github.com/user/repo

# Deploy a specific Docker image:
maritime deploy my-agent --source docker --image myimage:latest

maritime start / stop / restart

Control the lifecycle of a deployed agent.

maritime start my-agent
maritime stop my-agent
maritime restart my-agent

maritime delete

Delete an agent. Prompts for confirmation unless -y is passed.

maritime delete my-agent

# Skip confirmation:
maritime delete my-agent -y

Observability

maritime logs

View logs from an agent.

maritime logs my-agent

# Show last 100 lines:
maritime logs my-agent -n 100

# Filter by level:
maritime logs my-agent --level error

maritime env

Manage environment variables for an agent.

# List variables:
maritime env list my-agent

# Set a variable (marked as secret by default):
maritime env set my-agent OPENAI_API_KEY=sk-...

# Set a non-secret variable:
maritime env set my-agent LOG_LEVEL=debug --no-secret

# Remove a variable:
maritime env remove my-agent LOG_LEVEL

maritime status

Show detailed status for a single agent — health, last activity, tier, container ID, host, and deployment state.

maritime status my-agent

maritime info

Print full metadata for an agent (env keys, framework, image, exposed ports, server placement).

maritime info my-agent

maritime history

Show deployment history for an agent — every build/deploy attempt with its outcome.

maritime history my-agent

# Show last 30 deployments:
maritime history my-agent -n 30

maritime exec

Run a command inside an agent container. Useful for one-off debugging.

maritime exec my-agent -- ls /data

# Pipe-style invocation:
maritime exec my-agent -- bash -lc "env | sort"

maritime triggers

List the cron/webhook/email/telegram/discord triggers wired to an agent.

maritime triggers my-agent

Lifecycle

maritime sleep

Put an active agent to sleep. Sleeping agents pause compute billing and auto-wake on triggers.

maritime sleep my-agent

maritime scale

Change an agent's tier. Higher tiers grant more memory and longer awake windows.

maritime scale my-agent extended

# Tiers: smart ($1/mo), extended ($5/mo), always_on ($10/mo)

maritime open

Open the agent's dashboard page in your default browser.

maritime open my-agent

Blueprints

A blueprint packages an agent (DB metadata + env-var keys + sanitized triggers + optional volume snapshot) so it can be cloned. Alias: maritime bp.

maritime blueprint list

maritime blueprint list

maritime blueprint create

Create a blueprint from a sleeping or stopped agent.

maritime blueprint create my-agent --name "Support Bot v2" --visibility unlisted

# --visibility: private | unlisted | public (default: private)

maritime blueprint deploy

Clone a blueprint into a new agent.

maritime blueprint deploy support-bot-v2 --name my-support-bot

Discovery

maritime templates

List available agent templates. This command does not require authentication.

maritime templates

Output Formatting

Most commands accept --json to emit machine-readable output instead of the pretty table. Combine with jq for scripting.

maritime list --json | jq '.[] | select(.status=="error") | .name'