Hilo Local
OfficialThis server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Hilo Local
Local-first persistent memory, reusable skills, and technical docs for AI coding agents.
Quickstart · Features · Architecture · MCP Setup · CLI Reference · Hilo Cloud
AI coding agents start every session with amnesia. Hilo Local gives Claude Code, Cursor, Antigravity, Codex, and OpenCode a fast, structured, local-first brain powered by SQLite + FTS5 and the Model Context Protocol (MCP).
No account required. No external native build tools. Works 100% offline — with optional Git sync and one-command OAuth cloud sync to hilomemory.app.
Why Hilo Local?
Capability | Hilo Local (MIT) | Basic Local Memory Tools | Hilo Cloud |
Typed memories ( | ✅ | Observations only | ✅ |
Session context loader ( | ✅ | ✅ | ✅ |
Reusable AI Skills ( | ✅ | ❌ | ✅ |
Indexed technical docs ( | ✅ | ❌ | ✅ |
Isolated local profiles ( | ✅ | ❌ | ✅ |
Decision & event history ( | ✅ | ❌ | ✅ |
Git-friendly Markdown sync | ✅ | ✅ | ✅ |
SQLite observation importer | ✅ | — | ✅ |
Remote OAuth MCP (web & mobile) | — | — | ✅ |
Tapiz, Calendar, Boards, Team Sync | — | — | ✅ |
Related MCP server: Sugar Memory
Features
Zero-dependency SQLite + FTS5: Uses Node.js built-in
node:sqlite(DatabaseSync) with automatic FTS5 full-text search triggers. No C++ compilation, Python, or Docker needed.Structured Memory Taxonomy: Separates durable
userandfeedbackrules (always loaded in full) fromprojectandreferencememories (indexed bytemaand fetched on demand).Cross-Agent Skills: Store and share reusable
SKILL.mdworkflows across all your local AI tools.Strict Profile Isolation: Switch between
default,work, or client-specific profiles so contexts never leak across projects.Git-First Portability: Export and import your entire profile as clean Markdown files with YAML frontmatter in
.hilo/.SQLite Observation Importer: Migrate existing observations from third-party local SQLite memory databases.
Optional Cloud Sync (OAuth 2.0 PKCE): Connect to hilomemory.app anytime with
hilo cloud loginto sync between your terminal, web, and mobile.
Architecture
Hilo Local is built around a storage-agnostic core (HiloStorage) so the exact same memory rules, context formatting, and MCP tool contracts work across both local SQLite and Hilo Cloud.
flowchart LR
Agents["AI Agents (Claude Code, Cursor, Antigravity, Codex)"] -->|MCP stdio| MCP["Hilo MCP Server"]
CLI["hilo CLI"] --> Core["@hilomemory/local Core (HiloStorage)"]
MCP --> Core
Core --> SQLite[("SQLite + FTS5 (~/.hilo/hilo.db)")]
Core <-->|export / import| Git[".hilo/ Markdown + Git"]
Core <-->|OAuth PKCE + /api/sync| Cloud["Hilo Cloud (hilomemory.app)"]Quickstart
1. Install
Requires Node.js >= 22.5 (built-in node:sqlite support).
npm install -g @hilomemory/localOr build from source:
git clone https://github.com/semillabiz/hilo-local.git
cd hilo-local
npm install
npm run build
npm link2. Save your first memory
hilo save code-style \
--type feedback \
--summary "Always write concise TypeScript without external runtime deps" \
--content "Prefer Node built-ins (node:sqlite, node:test) and strict types."3. Connect your AI agent via MCP
Run the interactive setup wizard to auto-detect and configure Claude Code, Cursor, Antigravity, Windsurf, or OpenCode:
hilo setupOr launch the interactive terminal UI (TUI) anytime:
hilo tuiMCP Setup
Add Hilo Local to your agent's MCP configuration:
claude mcp add hilo-local -- hilo mcp{
"mcpServers": {
"hilo-local": {
"command": "hilo",
"args": ["mcp"]
}
}
}Exposed MCP Tools
Group | Tools |
Context |
|
Memories |
|
Skills |
|
Docs |
|
History |
|
Profiles |
|
Cloud Sync |
|
CLI Reference
Memories & Context
# Print the full context bundle for the active profile (optionally filtered by tema)
hilo context --tema backend
# Save or update a memory
hilo save db-choice --type project --tema backend \
--summary "Use SQLite FTS5 for local search" \
--content "Chosen for zero-config offline full-text ranking."
# Full-text search (FTS5)
hilo search "SQLite"
# Read a full memory
hilo get db-choiceIsolated Profiles
hilo profile list
hilo profile use work --name "Work"Git Sync & SQLite Migration
# Export active profile to .hilo/ (Markdown + frontmatter)
hilo export
# Import from .hilo/ into SQLite (idempotent)
hilo import
# Import observations from an existing SQLite observations DB
hilo import-engram /path/to/observations.dbCloud Sync (Optional)
# Create a 12-word seed-phrase account on Hilo Web and link this terminal via OAuth
hilo cloud register
# Or authenticate an existing account via browser using OAuth 2.0 PKCE
hilo cloud login
# Headless / remote terminal login
hilo cloud login --manual
# Or with a static API token
hilo cloud login --token <your-token>
# Sync bidirectionally (pull + push)
hilo cloud sync
# Check status or log out
hilo cloud status
hilo cloud logoutEnvironment Variables
Variable | Default | Description |
|
| Custom SQLite database path |
| Active DB profile ( | Override active profile ID |
|
| Custom cloud credentials path |
|
| Custom Hilo Cloud server origin |
| — | Static Bearer token override |
Hilo Cloud
Hilo Local is 100% free and open source under MIT. When you need your context outside the terminal, connect it to hilomemory.app:
Remote OAuth MCP: Access your memories and skills from Claude web, mobile apps, and cloud agents without keeping your laptop online.
Visual Workspace: Tapiz (block pages & databases), Calendar, Boards, Sheets, Forms, Projects, and the 3D Profile Constellation.
Managed Connectors & Team Sync: Native integrations with GitHub, Notion, Google Calendar, and Semilla ERP, plus real-time multi-user permissions without Git merge conflicts.
Development & Tests
npm install
npm testTests run against node:test and cover SQLite + FTS5 search, profile isolation, Git Markdown roundtrips, SQLite observation migration, /api/sync push/pull, and OAuth 2.0 PKCE + refresh_token renewal.
License
MIT © 2026 Hilo Memory
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Shared memory for coding agents. Stop re-explaining your codebase every session.
Private memory for AI agents: save and recall facts across Claude Code, Codex, Cursor and ChatGPT.
Universal memory for AI agents and tools. Save, organize and search context anywhere.
Persistent memory for AI agents. Semantic search, memory graph, W3C DID identity.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides AI coding assistants with persistent project memory to retain architectural decisions, code patterns, and domain knowledge across sessions. It stores data locally in a SQLite database, allowing agents to remember, recall, and manage project-specific context using full-text search.3 npmApache 2.0
- FlicenseNot gradedqualityAmaintenanceProvides AI coding agents with a local-first persistent memory layer they can read and write during sessions, storing decisions, preferences, error patterns, and research per project or globally. Enables semantic and keyword search, formatted context recall, and cross-project guideline surfacing without API keys or cloud storage.-
- FlicenseNot gradedqualityAmaintenanceProvides a local-first persistent memory layer that lets AI coding agents store, recall, and semantically search project-specific and cross-project knowledge across sessions, so context, decisions, and guidelines survive between conversations. Runs entirely on the user's machine with SQLite and no API keys, and optionally supports autonomous task-queue execution built on the same memory.-
- FlicenseNot gradedqualityAmaintenanceGives AI coding agents a local-first persistent memory they can read and write directly during sessions, storing decisions, preferences, error patterns, and guidelines in per-project and global SQLite stores. Enables semantic and keyword retrieval of relevant context across sessions so agents start work already knowing a codebase's conventions and history.-