Skip to main content

​
Other Commands

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

​
Configuration Commands

​
Login

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