LH(1)

NAME
lh - LobeHub CLI - manage and connect to LobeHub services

SYNOPSIS
lh [OPTION]... [COMMAND]
lobe [OPTION]... [COMMAND]
lobehub [OPTION]... [COMMAND]

DESCRIPTION
lh is the command-line interface for LobeHub. 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:

    lh man [COMMAND]...

COMMANDS

login
    Log in to LobeHub via browser (Device Code Flow) or configure API key server

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

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

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
    Manage AI models

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

provider
    Manage AI providers

plugin
    Manage plugins

user
    Manage user account and settings

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

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

~/.lobehub/settings.json
    CLI settings such as server and gateway URLs.

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

~/.lobehub/daemon.status
    Background daemon status metadata.

~/.lobehub/daemon.log
    Background daemon log output.

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

EXAMPLES

lh login
    Start interactive login in the browser.

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

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

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

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

SEE ALSO
lobe(1), lobehub(1)