CLI

CLI

Install and configure the Ink CLI — deploy, manage, and observe your services from the terminal

The Ink CLI gives you direct access to every Ink capability from the command line. Use it standalone, in CI/CD pipelines, or as the engine behind the Ink Skill for AI agents.

Installation

npm install -g @mldotink/cli
brew install mldotink/tap/ink
go install github.com/mldotink/cli@latest

Verify the installation:

ink --version

Authentication

Browser login

ink login

Opens your browser for OAuth authentication. Credentials are saved to ~/.config/ink/config by default.

To save credentials to the current project instead of globally:

ink login --global=false

This writes a .ink file in the current directory (auto-added to .gitignore).

API key

ink login --api-key dk_live_your_key_here

Get an API key from ml.ink Settings.

Environment variable

export INK_API_KEY=dk_live_your_key_here

Useful for CI/CD and scripts.

Verify

ink whoami

Shows your account, current workspace, plan, and connection status.

Configuration

Ink resolves configuration in this order (highest priority first):

  1. CLI flags--api-key, --workspace, --project
  2. Environment variableINK_API_KEY
  3. Local config.ink file in the current directory
  4. Global config~/.config/ink/config

Set defaults

ink config set workspace my-team
ink config set project backend

View current config

ink config show

Global flags

Every command accepts these flags:

FlagDescription
--jsonOutput as JSON (for scripting)
--workspace, -wOverride workspace
--projectOverride project
--api-keyOverride API key

Quick example

# Login
ink login

# Deploy a service from an Ink-managed repo
ink deploy my-app --port 3000

# Check status
ink status my-app

# View logs
ink logs my-app

What's next

On this page