localnest: Skill for Claude Code

LocalNest MCP

Local-first MCP server: code retrieval + persistent agent memory. 72 tools, pure SQLite, zero cloud.

Philosophy: evidence-first, capture-always, minimal-ceremony (just {title, content} to store).

Quick Start

1. localnest_agent_prime({ task: "your task" }) -- one call: memories + entities + files + changes + actions
2. localnest_find({ query: "..." }) -- fused search across memory, code, and KG
3. localnest_memory_store({ title: "...", content: "..." }) -- save a decision (everything else auto-inferred)

Key Workflows

Cold start: agent_prime replaces 4+ separate calls. Always start here.

Search: find for cross-domain. search_files({ query, project_path }) for paths. search_code({ query, project_path, context_lines: 5 }) for exact symbols. search_hybrid({ query, project_path, max_results: 20 }) for concepts.

Bulk writes: Use _batch variants for 3+ items: memory_store_batch({ memories: [...], response_format: "minimal" }) (100/call), kg_add_triples_batch({ triples: [...] }) (500/call), kg_add_entities_batch({ entities: [...] }) (500/call).

Token savings: Pass terse: "minimal" to any write tool for {id, ok} instead of full payload.

Teach: localnest_teach({ instruction: "always use snake_case in this repo" }) -- persists across sessions.

Recall: memory_recall({ query: "...", nest: "project-name" }). Results include related_facts from KG.

What changed: whats_new({ since: "last_session" }) -- cross-session delta.

Code intel: find_definition({ symbol: "MyClass" }), find_callers({ symbol: "handleAuth" }), find_implementations({ symbol: "Parser" }), rename_preview({ symbol: "oldName", new_name: "newName" }).

KG facts: kg_add_triple({ subject_name, predicate, object_name }). Query: kg_query({ entity_name }). Timeline: kg_timeline({ entity_name }). Point-in-time: kg_as_of({ entity_name, as_of_date }).

Proactive hints: read_file auto-surfaces _memory_hints for linked high-importance memories. After edits: file_changed({ file_path: "..." }) returns memories that may need updating.