CLRV(1)

NAME
clrv - Clerval CLI - manage and connect to Clerval services

SYNOPSIS
clrv [OPTION]... [COMMAND]

DESCRIPTION
clrv is the command-line interface for Clerval. It provides authentication, device gateway connectivity, content generation, resource search, and management commands for agents, files, models, providers, plugins, knowledge bases, threads, topics, and related resources.

For command-specific manuals, use the built-in manual command:

    clrv man [COMMAND]...

COMMANDS

login
    Log in to Clerval via browser (Device Code Flow) or Clerval API key

logout
    Log out and remove stored credentials

completion
    Output shell completion script

man Show a manual page for the CLI or a subcommand

connect
    Connect to the device gateway and listen for tool calls

disconnect
    Disconnect from the device gateway (alias for `connect stop`)

device
    Manage connected devices

status
    Check if gateway connection can be established

doc Manage documents

search
    Search across local resources or the web

kb  Manage knowledge bases, folders, documents, and files

memory
    Manage user memories

agent
    Manage agents

agent-group
    Manage agent groups

agent-signal
    Inspect and trigger Agent Signal source events

bot Manage bot integrations

cron
    Manage agent cron jobs

generate
    Generate content (text, image, video, speech) Alias: gen.

file
    Manage files

hetero
    Run heterogeneous agent CLIs (Claude Code / Codex) and stream their output

skill
    Manage agent skills

session-group
    Manage agent session groups

task
    Manage agent tasks

thread
    Manage message threads

topic
    Manage conversation topics

message
    Manage messages

model
    View and toggle Clerval-managed AI models

notify
    Send a callback message to a topic and trigger the agent to process it

provider
    View and toggle Clerval-managed AI providers

plugin
    Manage plugins

user
    Manage user account and settings

verify
    Manage the Agent Run delivery checker (criteria, rubrics, plans, results)

whoami
    Display current user information

usage
    View usage statistics

eval
    Manage evaluation workflows

migrate
    Migrate data from external tools (OpenClaw, ChatGPT, Claude, etc.)

OPTIONS

-V, --version
    output the version number

-h, --help
    display help for command

FILES

~/.clerval/credentials.json
    Encrypted access and refresh tokens.

~/.clerval/settings.json
    Legacy settings file (removed on load).

~/.clerval/daemon.pid
    Background daemon PID file.

~/.clerval/daemon.status
    Background daemon status metadata.

~/.clerval/daemon.log
    Background daemon log output.

The base directory can be overridden with the CLERVAL_CLI_HOME environment variable.

EXAMPLES

clrv login
    Start interactive login in the browser.

clrv connect --daemon
    Start the device gateway connection in the background.

clrv search -q gpt-5
    Search local resources for a query.

clrv generate text Write release notes
    Generate text from a prompt.

clrv man generate
    Show the built-in manual for the generate command group.

SEE ALSO
clrv(1)