Other Commands

Reference guide for additional CLI commands including configuration, facilitator operations, organizations, and utilities.

Configuration Commands

Authenticate via browser login. Opens your browser, waits for you to sign in, and saves the API key to your CLI config:

nevermined login
nevermined login --environment live
nevermined login --profile production --environment live
nevermined login --no-browser  # Print URL instead of opening browser

Logout

Remove your API key from the local configuration so you need to authenticate again:

nevermined logout
nevermined logout --profile production
nevermined logout --all-profiles  # Remove API keys from every profile

Initialize Configuration

Set up your CLI configuration interactively:

nevermined config init

Interactive prompts:

NVM API Key
Environment (sandbox, live)
Profile name (optional)

Flags:

--api-key — Provide API key non-interactively
--environment — Set environment (sandbox, live)
-i, --interactive — Interactive mode (default: true)

View Configuration

Display your current configuration:

nevermined config show

# Show all profiles
nevermined config show --all

Output:

Current Configuration
Active Profile: default
Environment:    sandbox
API Key:        sandbox:eyJxxxxaaaa...bbbbbbbb (truncated)
Config File:    /home/user/.config/nvm/config.json

Set Configuration Values

Update specific configuration values:

# Set API key
nevermined config set nvmApiKey sandbox:eyJxxxxaaaa...bbbbbbbb

# Set environment
nevermined config set environment sandbox

# Set active profile
nevermined config set activeProfile production

Configuration File Structure

The config file at ~/.config/nvm/config.json:

{
  "profiles": {
    "default": {
      "nvmApiKey": "sandbox:eyJxxxxaaaa...bbbbbbbb",
      "environment": "sandbox"
    },
    "production": {
      "nvmApiKey": "live:eyJyyyybbbb...",
      "environment": "live"
    }
  },
  "activeProfile": "default"
}

Facilitator Commands

Facilitator commands are used by agent owners to verify and settle permissions (credit burning).

Verify Permissions

Verify that a subscriber has permission to use credits from a payment plan. This simulates credit usage without actually burning credits:

nevermined facilitator verify-permissions \
  --params verify.json

verify.json:

{
  "paymentRequired": "eyJhbGci...",
  "x402AccessToken": "eyJhbGci...",
  "maxAmount": "5"
}

Settle Permissions

Settle (burn) credits from a subscriber’s payment plan. This executes the actual credit consumption:

nevermined facilitator settle-permissions \
  --params settle.json

settle.json:

{
  "paymentRequired": "eyJhbGci...",
  "x402AccessToken": "eyJhbGci...",
  "maxAmount": "5"
}

Organizations Commands

Manage organization members and settings.

List Members

View all members in your organization:

nevermined organizations get-members

# Filter by role
nevermined organizations get-members --role admin

# Filter active members
nevermined organizations get-members --is-active true

# Pagination
nevermined organizations get-members --page 1 --offset 10

Create Member

Add a new member to your organization:

nevermined organizations create-member <user-id>

# With email and role
nevermined organizations create-member <user-id> --user-email "john@example.com" --user-role "developer"

Flags:

--user-email — Member’s email address (optional)
--user-role — Member’s role (optional)

Connect Stripe Account

Connect a user with Stripe for fiat payments:

nevermined organizations connect-stripe-account \
  --user-email "john@example.com" \
  --user-country-code "US" \
  --return-url "https://yourapp.com/stripe-callback"

All flags are required:

--user-email — User’s email address
--user-country-code — Two-letter country code
--return-url — URL to redirect after Stripe connection

X402 Token Commands

Get X402 Access Token

Generate an access token for a plan with delegated permissions:

nevermined x402token get-x402-access-token <plan-id>

Example:

nevermined x402token get-x402-access-token "did:nvm:abc123"

Optional flags:

--agent-id — Target agent ID
--redemption-limit — Maximum credits that can be redeemed
--order-limit — Maximum number of orders
--expiration — Token expiration time

Example with options:

nevermined x402token get-x402-access-token "did:nvm:abc123" \
  --agent-id "did:nvm:agent456" \
  --redemption-limit 100 \
  --expiration 3600

Output:

X402 Access Token
Token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Plan ID: did:nvm:abc123

Save Token

Save token for later use:

# Save to environment variable
export X402_TOKEN=$(nevermined x402token get-x402-access-token "did:nvm:abc123" \
  --format json | jq -r '.token')

# Use token in requests
curl -H "payment-signature: $X402_TOKEN" https://agent-api.example.com

Global Flags

All commands support these global flags:

Format Flag

Control output format:

# Table output (default)
nevermined plans get-plans

# JSON output
nevermined plans get-plans --format json

# Quiet output (minimal)
nevermined plans get-plans --format quiet

Profile Flag

Use a specific configuration profile:

# Use production profile
nevermined --profile production plans get-plans

# Use staging profile
nevermined --profile staging agents get-agent <agent-id>

Verbose Flag

Enable verbose output with detailed logging:

nevermined plans order-plan "did:nvm:abc123" --verbose

Output includes:

Request/response details
Stack traces for errors
Debug information

Utility Commands

Version Information

Check CLI version:

nevermined --version

Help

Get help for commands:

# General help
nevermined --help

# Topic help
nevermined plans --help
nevermined agents --help
nevermined config --help

# Command help
nevermined plans get-plan --help
nevermined agents register-agent --help

Scripting Examples

Environment Switcher

Switch between environments easily:

#!/bin/bash
case $1 in
  production)
    nevermined config set activeProfile production
    echo "Switched to production environment"
    ;;
  sandbox)
    nevermined config set activeProfile default
    echo "Switched to sandbox environment"
    ;;
  *)
    echo "Usage: $0 {production|sandbox}"
    exit 1
    ;;
esac

nevermined config show

Multi-Profile Operations

Run commands across multiple profiles:

#!/bin/bash
PROFILES=("default" "production")
COMMAND="$@"

for PROFILE in "${PROFILES[@]}"; do
  echo "Profile: $PROFILE"
  nevermined --profile $PROFILE $COMMAND
  echo ""
done

Usage:

./multi-profile.sh plans get-plans

Integration Examples

CI/CD Pipeline

Use CLI in CI/CD:

# .github/workflows/deploy-agent.yml
name: Deploy Agent

on:
  push:
    tags:
      - 'v*'

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2

      - name: Install CLI
        run: npm install -g @nevermined-io/cli

      - name: Configure CLI
        run: |
          nevermined config set nvmApiKey ${{ secrets.NVM_API_KEY }}
          nevermined config set environment live

      - name: Register Agent
        run: |
          nevermined agents register-agent \
            --agent-metadata agent.json \
            --agent-api "https://api.example.com" \
            --payment-plans "${{ secrets.PLAN_ID }}"

Common Issues

”Config file not found”

Initialize configuration:

nevermined login
# or
nevermined config init

“Invalid profile”

Check available profiles:

nevermined config show --all

“Permission denied”

Fix config file permissions:

chmod 600 ~/.config/nvm/config.json

Next Steps

Getting Started - Installation and setup
Plans - Create and manage plans
Agents - Register and manage agents
Purchases - Order plans and manage credits
Querying - Query agents with X402 tokens

TypeScript SDK

Python SDK

CLI

OpenClaw Plugin

Other Commands

Other Commands

Configuration Commands

Logout

Initialize Configuration

View Configuration

Set Configuration Values

Configuration File Structure

Facilitator Commands

Verify Permissions

Settle Permissions

Organizations Commands

List Members

Create Member

Connect Stripe Account

X402 Token Commands

Get X402 Access Token

Save Token

Global Flags

Format Flag

Profile Flag

Verbose Flag

Utility Commands

Version Information

Help

Scripting Examples

Environment Switcher

Multi-Profile Operations

Integration Examples

CI/CD Pipeline

Common Issues

”Config file not found”

“Invalid profile”

“Permission denied”

Next Steps

​Other Commands

​Configuration Commands

​Login

​Logout

​Initialize Configuration

​View Configuration

​Set Configuration Values

​Configuration File Structure

​Facilitator Commands

​Verify Permissions

​Settle Permissions

​Organizations Commands

​List Members

​Create Member

​Connect Stripe Account

​X402 Token Commands

​Get X402 Access Token

​Save Token

​Global Flags

​Format Flag

​Profile Flag

​Verbose Flag

​Utility Commands

​Version Information

​Help

​Scripting Examples

​Environment Switcher

​Multi-Profile Operations

​Integration Examples

​CI/CD Pipeline

​Common Issues

​”Config file not found”

​“Invalid profile”

​“Permission denied”

​Next Steps

Other Commands

Configuration Commands

Login

Logout

Initialize Configuration

View Configuration

Set Configuration Values

Configuration File Structure

Facilitator Commands

Verify Permissions

Settle Permissions

Organizations Commands

List Members

Create Member

Connect Stripe Account

X402 Token Commands

Get X402 Access Token

Save Token

Global Flags

Format Flag

Profile Flag

Verbose Flag

Utility Commands

Version Information

Help

Scripting Examples

Environment Switcher

Multi-Profile Operations

Integration Examples

CI/CD Pipeline

Common Issues

”Config file not found”

“Invalid profile”

“Permission denied”

Next Steps