@lobehub/cli

LobeHub command-line interface.

Local Development

| Task | Command | | ------------------------------------------ | -------------------------- | | Run in dev mode | bun run dev -- <command> | | Build the CLI | bun run build | | Link lh/lobe/lobehub into your shell | bun run cli:link | | Remove the global link | bun run cli:unlink |

• bun run build only generates dist/index.js.
• To make lh available in your shell, run bun run cli:link.
• After linking, if your shell still cannot find lh, run rehash in zsh.

Custom Server URL

By default the CLI connects to https://app.lobehub.com. To point it at a different server (e.g. a local instance):

| Method | Command | Persistence | | -------------------- | --------------------------------------------------------------- | ----------------------------------- | | Environment variable | LOBEHUB_SERVER=http://localhost:4000 bun run dev -- <command> | Current command only | | Login flag | lh login --server http://localhost:4000 | Saved to ~/.lobehub/settings.json |

Priority: LOBEHUB_SERVER env var > settings.json > default official URL.

Shell Completion

Install completion for a linked CLI

| Shell | Command | | ------ | ------------------------------ | | zsh | source <(lh completion zsh) | | bash | source <(lh completion bash) |

Use completion during local development

| Shell | Command | | ------ | -------------------------------------------- | | zsh | source <(bun src/index.ts completion zsh) | | bash | source <(bun src/index.ts completion bash) |

• Completion is context-aware. For example, lh agent <Tab> shows agent subcommands instead of top-level commands.
• If you update completion logic locally, re-run the corresponding source <(...) command to reload it in the current shell session.
• Completion only registers shell functions. It does not install the lh binary by itself.

Quick Check

which lh
lh --help
lh agent <TAB>