CLI Overview

The HEBBS CLI connects to your enterprise server over REST. Install it, log in, and you have full access to all memory operations from the command line.

Install

curl -sSf https://hebbs.ai/install | sh

Or via Homebrew:

brew install hebbs-ai/tap/hebbs

Connect

hebbs login --endpoint http://your-server:8080 --api-key hb_live_sk_...

This saves the endpoint and API key to ~/.config/hebbs/cli.toml. All subsequent commands use the saved connection.

Core Commands

hebbs recall "your query"                          # search memories
hebbs remember "important fact" --entity-id acme   # store a memory
hebbs push ./docs                                  # upload files
hebbs status                                       # check server health

Global Flags

Flag	Env Var	Description
--endpoint URL	HEBBS_ENDPOINT	Server URL
--api-key KEY	HEBBS_API_KEY	API key for authentication
--workspace SLUG	HEBBS_WORKSPACE	Route requests to a specific workspace
--format		Output format: human, json, raw
--color		Color: always, never, auto
-v / -vv		Verbose / trace logging

Key Capabilities

• All memory operations: remember, recall, revise, forget, prime, reflect, insights
• File upload: push files and directories for server-side indexing
• Workspace routing: target any workspace with --workspace, or save a default with workspaces switch
• API key management: list, create, revoke keys
• Multiple output formats: human-readable tables (default), JSON for scripting, raw for piping

Next Steps

• Commands Reference - all available commands with flags and examples
• Output Formats - control output formatting
• REPL - interactive mode