Back to Lobehub

Search & Configuration Commands

.agents/skills/cli/references/search-config.md

2.2.165.6 KB
Original Source

Search & Configuration Commands

Global Search (lh search)

Search across all LobeHub resource types.

Source: apps/cli/src/commands/search.ts

lh search <query>

bash
lh search "meeting notes" [-t [-L [--json [fields]] < type > ] < n > ]
OptionDescriptionDefault
-t, --type <type>Filter by resource typeAll types
-L, --limit <n>Results per type10

Searchable Types

TypeDescription
agentAI agents
topicConversation topics
fileUploaded files
folderFile folders
messageChat messages
pageDocuments/pages
memoryUser memories
mcpMCP servers
pluginInstalled plugins
communityAgentCommunity marketplace agents
knowledgeBaseKnowledge bases

Output: Results grouped by type, showing ID, title/name, description.


User Configuration (lh whoami / lh usage)

Source: apps/cli/src/commands/config.ts

lh whoami

Display current authenticated user information.

bash
lh whoami [--json [fields]]

Displays: Name, username, email, user ID, subscription plan.

lh usage

Display usage statistics.

bash
lh usage [--month [--daily] [--json [fields]] < YYYY-MM > ]
OptionDescriptionDefault
--month <YYYY-MM>Month to queryCurrent month
--dailyGroup by dayfalse (monthly total)

Output: Token usage, costs, and model breakdown for the specified period.


Workspace (lh workspace)

Aliased lh ws. Workspace membership is a cloud feature; on an open-source deployment these procedures answer empty or NOT_IMPLEMENTED.

Scope

CommandDescription
lh workspace currentWhich scope commands run under, and where it came from
lh workspace use <id|slug>Persist the scope for subsequent commands
lh workspace use --personalDrop back to personal content

Resolution order is --workspaceLOBEHUB_WORKSPACE_ID → the persisted scope → personal. Setting the persisted scope while LOBEHUB_WORKSPACE_ID is exported prints a warning, because the env var still wins.

The persisted scope lives in ~/.lobehub/active-workspace together with the account (sub claim) and server URL it was chosen under. Switching account or server invalidates it; lh logout deletes it. API-key auth has no local account identity, so workspace use refuses to save under it — use the env var.

Reads

CommandDescription
lh workspace listWorkspaces you belong to; * marks the effective one
lh workspace view [id]Workspace detail
lh workspace settingsThe workspace settings blob
lh workspace statsContent totals — admin only; --mine for your own
lh workspace usageCredit spend by type for the billing window
lh workspace membersMembers with role and email
lh workspace invitationsPending invitations (admin)
lh workspace audit-logAudit entries (admin, Business plan)

Writes

CommandDescription
lh workspace create <name> --slugCreate a workspace; --use switches into it
lh workspace updateName / slug / description / avatar (admin)
lh workspace invite <email>Invite a member, --role admin|member|viewer

Slugs are 3–32 chars, lowercase alphanumerics with inner hyphens. Deleting a workspace and removing members are deliberately not exposed here.


Global Options

These options are available across most commands:

OptionDescription
--json [fields]Output as JSON; optionally filter to specific fields (comma-separated)
--yesSkip confirmation prompts for destructive operations
-L, --limit <n>Pagination limit for list commands
-v, --verboseEnable verbose/debug logging
--helpShow command help
--versionShow CLI version

JSON Field Filtering

The --json option supports field selection:

bash
# Full JSON output
lh agent list --json

# Only specific fields
lh agent list --json "id,title,model"