CLI Reference
Complete command reference for the Web42 CLI.
Installation
Install the Web42 CLI using any of the methods below. No runtime dependencies required.
Verify the installation by checking the version:
Global options
Overrides the API URL for a single invocation. Useful for development or self-hosted instances.
Authentication
Manage your Web42 credentials. Authentication uses GitHub OAuth device flow.
auth login
Starts the GitHub OAuth device flow. Opens your browser for authorization and polls until the flow completes. Your auth token is stored locally.
auth logout
Clears stored credentials from your machine.
auth whoami
Displays your authenticated username and current API URL.
Agent commands
Create, bundle, and publish agents to the marketplace. See the Quickstart and Publishing guide for walkthroughs.
init
Create a manifest.json interactively. Prompts for platform, name, description, version, category, tags, model preferences, and demo video URL. Scaffolds platform-specific files (AGENTS.md, IDENTITY.md, SOUL.md, etc.) and auto-detects skills from skills/*/SKILL.md. Requires authentication.
pack
Bundle your agent into a .web42/ directory. Strips secrets from skill files and replaces them with placeholders. Merges config variables from skills into the manifest. Use --dry-run to preview without writing files.
push
Push your agent to the Web42 marketplace. If no .web42/ directory exists, runs pack automatically first. Reads README.md from the current directory if present and includes it. Creates a new agent or updates an existing one.
pull
Fetch the latest version of your agent's files from the marketplace into your current directory.
search
Search the marketplace for agents matching your query. Results show agent name, description, and the platform install command. Uses full-text search across name, description, skills, and readme.
remix
Copy an existing agent to your account. Requires access to the agent (owner, free acquisition, or purchase for paid agents).
Configuration commands
config show
Display current configuration: API URL, authentication status, and username.
config set-url
Override the default API URL. Persists across sessions.
Platform commands
Platform-specific commands registered through adapters. Currently only OpenClaw is supported. Each platform provides install, uninstall, update, and list commands.
openclaw install
Install an agent into your OpenClaw workspace. Creates a workspace directory, merges configuration into openclaw.json, and prompts for any required config variables (API keys, tokens). Config values are stored in .web42.config.json.
openclaw uninstall
Remove an installed agent. Deletes the workspace directory and cleans up config entries.
openclaw update
Update all installed agents to their latest marketplace versions.
openclaw list
List all agents currently installed in your OpenClaw environment.
Configuration files
CLI config
Stored via the conf package in your system config directory. Contains the API URL (defaults to production), auth token, and username. Managed by the auth and config commands.
.web42.config.json
Created in the agent workspace during install. Stores config variable values (API keys, tokens) for each installed agent. This file should never be committed to version control.