CLI Commands
Complete reference for every Lore CLI command.
lore login
Authenticate with Lore and configure your local environment.
lore login
lore login --url http://localhost:3001
Opens a browser to complete OAuth authentication. On success, writes your Personal Access Token and workspace list to ~/.lore/config.json. If you belong to multiple workspaces, you'll be prompted to choose one interactively.
Options:
| Flag | Default | Description |
|---|---|---|
--url <url> | http://localhost:3001 | Lore server URL |
Alias: lore setup
lore capture
Send a text snippet to the Lore ingestion pipeline.
lore capture "your knowledge snippet here"
lore capture - # read from stdin
echo "note" | lore capture
The text is sent to /api/ingest/cli with your Personal Access Token and active workspace. If the text is empty or no authentication is configured, the command exits with a clear error.
Arguments:
| Argument | Required | Description |
|---|---|---|
text | No | The text to capture. Omit or pass - to read from stdin. |
Exit codes:
| Code | Meaning |
|---|---|
| 0 | Captured successfully |
| 1 | Authentication error, empty text, network error, or server error |
lore workspace list
Show all cached workspaces with their names and roles. The active workspace is prefixed with *.
lore workspace list
lore workspace use <slug>
Switch the active workspace by slug. The slug must match a workspace in your cached list — if it doesn't, the command prints available options.
lore workspace use acme-platform
lore workspace show
Display the active workspace's name, slug, and your role.
lore workspace show