CLI reference

The Cognoverge CLI wraps every action you can take on the platform. Every command is idempotent, streams JSON output when passed --json, and reads config from your current directory's cognoverge.json.

Installation

bash

# Global install (recommended)
npm install -g @cognoverge/cli

# Verify
cognoverge --version   # → 0.4.2

# One-off usage
npx @cognoverge/cli deploy

Global flags

Flag	Effect
--project <name>	Override project detected from cognoverge.json.
--region <slug>	Pin operation to a specific edge region.
--json	Emit newline-delimited JSON for scripting.
--quiet	Suppress logs; exit code only.
--verbose	Include HTTP timing and stack traces on error.
--profile <name>	Use a specific auth profile (see whoami).
--api <url>	Point at an alternate API host. Rarely needed.

cognoverge init

Scaffold a new MCP server with a sensible directory layout, TypeScript or Python starter, and a cognoverge.json project file.

bash

cognoverge init <name> [flags]

  --template ts | py       Language starter (default: ts)
  --tool <name>            Add a starter tool by name (repeatable)
  --dir <path>             Target directory (default: <name>)
  --no-install             Skip npm/pip install

bash

# Minimal
cognoverge init hello-mcp

# Python with two starter tools
cognoverge init crm-mcp --template py --tool search --tool create

cognoverge deploy

Bundle, upload, and publish the current project. Idempotent. Writes a new version and points production traffic at it.

bash

cognoverge deploy [flags]

  --preview                Create a preview URL without touching production
  --alias <name>           Publish under an alias domain (e.g. staging)
  --note "<text>"          Attach a release note (shows in dashboard)
  --skip-lint              Skip pre-deploy type + schema checks

bash

# Regular deploy
cognoverge deploy --note "Add pages.archive tool"

# Preview for a pull request
cognoverge deploy --preview
# → https://pr-142.notion-mcp.you.cognoverge.dev

cognoverge add

Configure a deployed MCP server inside a specific MCP client. Writes the correct config file for the client and initiates OAuth.

bash

cognoverge add <server> --client=<name>

Supported clients:
  claude       Claude Desktop (macOS, Windows)
  cursor       Cursor (macOS, Windows, Linux)
  windsurf     Windsurf (macOS, Windows)
  cline        Cline (VS Code extension)
  continue     Continue (VS Code, JetBrains)
  zed          Zed (macOS, Linux)

bash

cognoverge add notion-mcp --client=claude
# ✓ Wrote ~/Library/Application Support/Claude/claude_desktop_config.json
# ✓ Restart Claude Desktop to load the server

cognoverge logs

Stream, filter, or export logs.

bash

cognoverge logs [flags]

  --tail                   Live-stream new logs
  --since <duration>       "10m", "1h", "24h", ISO timestamp
  --grep <pattern>         Filter by regex on any field
  --code <code>            Filter by HTTP status (comma-separated)
  --server <name>          Restrict to one server
  --tool <name>            Restrict to one tool
  --format json | tsv      Output format (default: pretty)

bash

# Live tail of errors on notion-mcp
cognoverge logs --tail --server notion-mcp --code 500,429

# Last hour of tools/call, exported as JSON to a file
cognoverge logs --since 1h --tool tools/call --format json > logs.jsonl

cognoverge env

Manage plain environment variables per server. For sensitive values, use secrets — they're encrypted at rest.

bash

cognoverge env list
cognoverge env set NOTION_API_BASE=https://api.notion.com
cognoverge env unset NOTION_API_BASE
cognoverge env pull > .env.local

cognoverge secrets

bash

cognoverge secrets list
cognoverge secrets set NOTION_TOKEN
# (prompts for value; never echoed to terminal)

cognoverge secrets rotate NOTION_TOKEN
cognoverge secrets unset NOTION_TOKEN

Secrets never leave the region

Cognoverge stores secret values with per-region envelope encryption. They're injected into your handler at request time and are never written to logs.

cognoverge rollback

Roll production traffic back to an earlier version — instantly, no rebuild required.

bash

cognoverge rollback              # → previous version
cognoverge rollback v1.4.2       # → specific version
cognoverge rollback --list       # show recent versions

cognoverge domain

bash

cognoverge domain add mcp.acme.com
# → Verify with DNS record: TXT _cognoverge=abc123
# → TLS provisioned in ~30s once DNS resolves

cognoverge domain list
cognoverge domain remove mcp.acme.com

cognoverge monetize

Turn a server into a paid product. See the monetize guide for the full setup flow.

bash

cognoverge monetize enable            # start Stripe Connect onboarding
cognoverge monetize price search 0.001
cognoverge monetize price create 0.005
cognoverge monetize disable

cognoverge whoami

bash

cognoverge whoami
# → devesh@build.so
# → workspace: acme-inc
# → profile: default

cognoverge login                # OAuth to a workspace
cognoverge logout               # forget local session
cognoverge profile use staging  # switch profile

CLI reference

Installation

bash

# Global install (recommended)
npm install -g @cognoverge/cli

# Verify
cognoverge --version   # → 0.4.2

# One-off usage
npx @cognoverge/cli deploy

Global flags

Flag	Effect
--project <name>	Override project detected from cognoverge.json.
--region <slug>	Pin operation to a specific edge region.
--json	Emit newline-delimited JSON for scripting.
--quiet	Suppress logs; exit code only.
--verbose	Include HTTP timing and stack traces on error.
--profile <name>	Use a specific auth profile (see whoami).
--api <url>	Point at an alternate API host. Rarely needed.

cognoverge init

Scaffold a new MCP server with a sensible directory layout, TypeScript or Python starter, and a cognoverge.json project file.

bash

cognoverge init <name> [flags]

  --template ts | py       Language starter (default: ts)
  --tool <name>            Add a starter tool by name (repeatable)
  --dir <path>             Target directory (default: <name>)
  --no-install             Skip npm/pip install

bash

# Minimal
cognoverge init hello-mcp

# Python with two starter tools
cognoverge init crm-mcp --template py --tool search --tool create

cognoverge deploy

Bundle, upload, and publish the current project. Idempotent. Writes a new version and points production traffic at it.

bash

cognoverge deploy [flags]

  --preview                Create a preview URL without touching production
  --alias <name>           Publish under an alias domain (e.g. staging)
  --note "<text>"          Attach a release note (shows in dashboard)
  --skip-lint              Skip pre-deploy type + schema checks

bash

# Regular deploy
cognoverge deploy --note "Add pages.archive tool"

# Preview for a pull request
cognoverge deploy --preview
# → https://pr-142.notion-mcp.you.cognoverge.dev

cognoverge add

Configure a deployed MCP server inside a specific MCP client. Writes the correct config file for the client and initiates OAuth.

bash

cognoverge add <server> --client=<name>

Supported clients:
  claude       Claude Desktop (macOS, Windows)
  cursor       Cursor (macOS, Windows, Linux)
  windsurf     Windsurf (macOS, Windows)
  cline        Cline (VS Code extension)
  continue     Continue (VS Code, JetBrains)
  zed          Zed (macOS, Linux)

bash

cognoverge add notion-mcp --client=claude
# ✓ Wrote ~/Library/Application Support/Claude/claude_desktop_config.json
# ✓ Restart Claude Desktop to load the server

cognoverge logs

Stream, filter, or export logs.

bash

cognoverge logs [flags]

  --tail                   Live-stream new logs
  --since <duration>       "10m", "1h", "24h", ISO timestamp
  --grep <pattern>         Filter by regex on any field
  --code <code>            Filter by HTTP status (comma-separated)
  --server <name>          Restrict to one server
  --tool <name>            Restrict to one tool
  --format json | tsv      Output format (default: pretty)

bash

# Live tail of errors on notion-mcp
cognoverge logs --tail --server notion-mcp --code 500,429

# Last hour of tools/call, exported as JSON to a file
cognoverge logs --since 1h --tool tools/call --format json > logs.jsonl

cognoverge env

Manage plain environment variables per server. For sensitive values, use secrets — they're encrypted at rest.

bash

cognoverge env list
cognoverge env set NOTION_API_BASE=https://api.notion.com
cognoverge env unset NOTION_API_BASE
cognoverge env pull > .env.local

cognoverge secrets

bash

cognoverge secrets list
cognoverge secrets set NOTION_TOKEN
# (prompts for value; never echoed to terminal)

cognoverge secrets rotate NOTION_TOKEN
cognoverge secrets unset NOTION_TOKEN

Secrets never leave the region

Cognoverge stores secret values with per-region envelope encryption. They're injected into your handler at request time and are never written to logs.

cognoverge rollback

Roll production traffic back to an earlier version — instantly, no rebuild required.

bash

cognoverge rollback              # → previous version
cognoverge rollback v1.4.2       # → specific version
cognoverge rollback --list       # show recent versions

cognoverge domain

bash

cognoverge domain add mcp.acme.com
# → Verify with DNS record: TXT _cognoverge=abc123
# → TLS provisioned in ~30s once DNS resolves

cognoverge domain list
cognoverge domain remove mcp.acme.com

cognoverge monetize

Turn a server into a paid product. See the monetize guide for the full setup flow.

bash

cognoverge monetize enable            # start Stripe Connect onboarding
cognoverge monetize price search 0.001
cognoverge monetize price create 0.005
cognoverge monetize disable

cognoverge whoami

bash

cognoverge whoami
# → devesh@build.so
# → workspace: acme-inc
# → profile: default

cognoverge login                # OAuth to a workspace
cognoverge logout               # forget local session
cognoverge profile use staging  # switch profile