@ntimpano/pi-flint

flint memory tools for Pi coding agent. Persist and recall context via local SQLite — no bash hacks needed.

Install

pi install npm:@ntimpano/pi-flint

Or from source:

pi install ./path/to/pi-flint

Tools

| Tool | Description | |------|-------------| | local_save | Save a note to local SQLite | | local_recall | Search notes by text query (scoped to active project) | | local_get | Get a single note by ID | | local_list | List recent notes (supports cross-project) |

Usage

# Save a discovery
local_save(content="Found auth pattern in middleware.ts...", title="auth pattern", topic_key="project/auth/middleware")

# Search prior context (always scoped to active project)
local_recall(query="auth middleware pattern")

# Search with type filter
local_recall(query="freshrss", type="bug")

# Read full note
local_get(id=42)

# Browse recent notes across all projects
local_list(limit=5, all_projects=true)

Important: recall scoping

local_recall is always scoped to the active project. This is by design — the flint recall CLI command filters results by the project associated with the current working directory, which keeps search results relevant and avoids noise from unrelated projects.

If you need to search across all projects:

1. Use local_list(all_projects=true) to browse recent notes globally.
2. Find the note ID you need from the list.
3. Use local_get(id=...) to read the full content.

Parameters

local_recall

| Parameter | Required | Description | |-----------|----------|-------------| | query | ✅ | Search query text | | type | ❌ | Filter by note type (decision, bug, discovery, session-state, research, architecture) | | since | ❌ | Filter notes since date (YYYY-MM-DD) | | until | ❌ | Filter notes until date (YYYY-MM-DD) | | limit | ❌ | ⚠️ Deprecated — not supported by the flint CLI. Accepted for API compat but ignored. | | all_projects | ❌ | ⚠️ Deprecated — recall is always project-scoped. Accepted for API compat but ignored. |

local_list

| Parameter | Required | Description | |-----------|----------|-------------| | limit | ❌ | Max results (default 10) | | all_projects | ❌ | Include notes from all projects (default: active project only) |

local_save

| Parameter | Required | Description | |-----------|----------|-------------| | content | ✅ | Note content | | title | ❌ | Short descriptive title | | topic_key | ❌ | Hierarchical key (e.g. sdd/my-change/spec) | | scope | ❌ | Project or user scope identifier | | type | ❌ | Note type: decision, discovery, bug, session-state, research, architecture |

local_get

| Parameter | Required | Description | |-----------|----------|-------------| | id | ✅ | Note ID (numeric) |

Changelog

v0.2.1 — 2025-05-24

Bug fix: local_recall query corruption

The flint recall CLI command does not support --all-projects or a positional limit argument. Previously, both were passed as CLI args, causing them to be silently absorbed into the search query string. For example, flint recall "freshrss" --all-projects would search for "freshrss" OR "--all-projects" in FTS5, returning irrelevant or empty results.

Changes:

• Removed --all-projects flag from local_recall args. Recall is always scoped to the active project.
• Removed positional limit from local_recall args. The flint CLI uses a fixed limit of 10.
• Reordered args: flags (--type=, --since=, --until=) now precede the query string, matching the CLI parser expectations.
• limit and all_projects parameters are kept for API compatibility but marked as deprecated and ignored.

Requirements

• flint binary must be installed and on PATH, or at ~/.local/bin/flint, or at /opt/flint/flint, or set via FLINT_BIN env var.
• flint v0.1.0+