CLI reference

The signup CLI is published on npm and runs via npx. No installation required.

Commands

npx signup <service>

Opens a browser consent window. After approval, credentials are written to .env.

Log into the dashboard

npx signup <service> login

Authenticates with your agent token from .env and opens the service’s dashboard.

List available services

npx signup list

Shows all services registered in the Gate registry.

Flags

Flag	Description
`-h`, `--help`	Show help
`-v`, `--version`	Show version
`-q`, `--quiet`	Suppress non-essential output (ASCII art, next steps)
`--json`	Output results as JSON to stdout (for scripts and agents)
`--registry-url`	Override the registry URL (for development)

JSON output

With --json, the CLI outputs a single JSON object to stdout on success:

{
  "status": "approved",
  "outputs": {
    "FOIL_GATE_AGENT_TOKEN": "agt_...",
    "FOIL_PUBLISHABLE_KEY": "pk_live_...",
    "FOIL_SECRET_KEY": "sk_live_..."
  },
  "env_path": "/path/to/.env",
  "docs_url": "https://usefoil.com/docs"
}

On failure:

{
  "status": "error",
  "message": "The signup was cancelled."
}

All human-readable output (steps, spinner, boxes) goes to stderr, so --json output is safe to pipe.

Environment variables

Variable	Description
`SIGNUP_REGISTRY_URL`	Override the default registry URL
`NO_COLOR`	Disable color output

What’s next

What is Gate? - overview of the Gate product
Dashboard login - reuse the Gate-managed login token for npx signup <service> login

Overview

Get started

Integrate Detection

Use cases

Learn

Gate: Agentic Signup

Integrate Gate

Resources

CLI reference

Commands

Log into the dashboard

List available services

Flags

JSON output

Environment variables

What’s next

​Commands

​Sign up for a service

​Log into the dashboard

​List available services

​Flags

​JSON output

​Environment variables

​What’s next

Commands

Sign up for a service

Log into the dashboard

List available services

Flags

JSON output

Environment variables

What’s next