@homeflare/hfm

CLI for the HomeFlare Memory MCP Server — knowledge graphs, semantic search, and temporal memory for LLMs.

Install

npm install -g @homeflare/hfm

Quick Start

# Configure
hfm config set --url https://memory.homeflare.dev

# Authenticate (opens browser via cloudflared)
hfm login

# Check status
hfm health
hfm whoami

# Create a namespace
hfm ns create my-project -d "Project knowledge base"

# Create entities
hfm entity create <ns_id> "Claude" "ai_agent" -s "AI assistant"
hfm entity create <ns_id> "React" "framework" -s "UI library"

# Link them
hfm relation create <ns_id> <source_id> <target_id> "uses"

# Store memories
hfm memory create <ns_id> "Claude prefers TypeScript" -t preference -i 0.8

# Search
hfm search <ns_id> "TypeScript preferences"

# Graph traversal
hfm traverse <entity_id> --depth 3

Features

• Full API coverage — namespaces, entities, relations, memories, conversations, messages, search, admin
• Cloudflare Access auth — login via browser (YubiKey/passkey) or service tokens for CI
• WARP / Zero Trust — auto-detects WARP CA cert, sends ZT challenge-response
• Encryption at rest — AES-256-GCM with HMAC blind indexes (server-side)
• Shell completion — hfm completion bash or hfm completion zsh
• JSON output — --json flag on every command for scripting
• Quiet mode — --quiet for pipe-friendly output
• Stdin input — --from-stdin for piping content

Service Token Auth (CI/CD)

export HFM_URL=https://memory.homeflare.dev
export HFM_CLIENT_ID=<service-token-client-id>
export HFM_CLIENT_SECRET=<service-token-secret>
hfm ns list

License

Apache-2.0 — The HomeFlare Project