open-index/open-npm huggingface dataset:
npm package: @homeflare/hfm
Description: CLI for HomeFlare Memory MCP Server — knowledge graphs, semantic search, and temporal memory
Author: Timothy Schneider
Latest version: 0.5.1

# @homeflare/hfm

CLI for the [HomeFlare Memory MCP Server](https://memory.homeflare.dev) — knowledge graphs, semantic search, and temporal memory for LLMs.

## Install

```bash
npm install -g @homeflare/hfm
```

## Quick Start

```bash
# 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)

```bash
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](https://homeflare.dev)