WebInfer

CLI Reference

Manage WebInfer servers, providers, and configuration from the command line

What is the WebInfer CLI?

The webinfer CLI is a command-line tool for managing WebInfer servers and configuration. It lets you run local daemon servers, manage providers, configure API keys, and more.

Best for:

  • • Developers who prefer terminal workflows
  • • Scripting and automation
  • • Server deployments
  • • Managing multiple providers
  • • CI/CD pipelines

Key features:

  • • Start daemon or gateway servers
  • • Add/remove provider API keys
  • • Import company provider configs
  • • Manage gateway access tokens
  • • View status and health info

Installation

The CLI comes bundled with the webinfer npm package. You can run it directly with npx or install it globally.

npx webinfer --help

Command Overview

terminal
webinfer <command> [subcommand] [options]Commands:  daemon     Start a local daemon server (desktop use)  gateway    Start a gateway server (multi-user, quotas)  provider   Manage LLM providers and API keys  config     Manage configuration  token      Manage gateway access tokens  model      Manage models  status     Show server status

Daemon Server

webinfer daemon
Start local server

Start a local WebInfer server on your desktop. Works with any browser, not just Chrome.

# Start with defaults (port 54321)npx webinfer daemon# Custom portnpx webinfer daemon --port 3000# Enable debug loggingnpx webinfer daemon --debug# Disable auth (development only!)npx webinfer daemon --no-auth# With system tray iconnpx webinfer daemon --tray

See the Node.js Daemon guide for more details.

Provider Management

webinfer provider
Manage LLM providers

Add, remove, and configure providers and their API keys.

# List all providerswebinfer provider list# Add a provider with API keywebinfer provider add openai --key sk-xxxwebinfer provider add anthropic --key sk-ant-xxx --priority 1# Add local providerwebinfer provider add ollama --host http://localhost:11434# Test provider connectionwebinfer provider test openai# Show provider detailswebinfer provider show openai# Enable/disable providerswebinfer provider enable openaiwebinfer provider disable openai# Remove providerwebinfer provider remove openai
Import Provider Configs

Companies can host provider configs for easy distribution to employees or users.

# Import from URLwebinfer provider import https://company.com/webinfer-provider.json --key xxx

Provider import file format:

{
  "$schema": "https://webinfer.com/schemas/provider-config.json",
  "version": "1.0",
  "provider": {
    "id": "webinfer-server",
    "displayName": "Acme Corp Gateway",
    "config": {
      "baseUrl": "https://llm.acme.com/gateway",
      "enabled": true,
      "priority": 1
    }
  },
  "requiresKey": true,
  "keyInstructions": "Contact IT at it@acme.com"
}

Configuration

webinfer config
Manage settings
# Show config pathswebinfer config path# List all configwebinfer config list# Get/set config valueswebinfer config get server.portwebinfer config set server.port 8080# Export/import configwebinfer config export -o backup.jsonwebinfer config import backup.json

Gateway Tokens

webinfer token
Manage access tokens

Create and manage access tokens for gateway authentication.

# Initialize gatewaywebinfer gateway init# Create access tokenwebinfer token create --name "Production App" \  --quota-limit 10000 \  --quota-period month \  --domains "app.example.com,example.com"# List tokenswebinfer token list# Show token usagewebinfer token usage <token-id># Revoke tokenwebinfer token revoke <token-id>

Status

webinfer status
Check server status
# General statuswebinfer status# Daemon statuswebinfer daemon status# Gateway statuswebinfer gateway status

Environment Variables

Provider API keys can be set via environment variables (takes precedence over config files).

OPENAI_API_KEYOpenAI API key
ANTHROPIC_API_KEYAnthropic API key
GOOGLE_AI_API_KEYGoogle AI API key
GROQ_API_KEYGroq API key

Config Directory

WebInfer stores configuration in ~/.webinfer/

~/.webinfer/
├── config.json              # Global settings
├── providers/
│   ├── openai.json          # Provider configs (chmod 600)
│   ├── anthropic.json
│   └── ...
├── gateway/
│   ├── secret.key           # Gateway signing key (chmod 600)
│   └── tokens/
│       └── {tid}.json       # Issued tokens
└── logs/
    └── webinfer.log

Provider config files contain API keys and are stored with restricted permissions (chmod 600).

Who Should Use the CLI?

Developers

Run local servers for development and testing. Quickly add or swap providers without leaving your terminal.

DevOps / IT

Script deployments, automate config distribution, and manage gateway tokens for your team.

Power Users

Manage multiple providers, switch between configs, and have full control over your WebInfer setup.