agent-store

name	agent-store
description	Core agent-store guide for initializing stores, creating records, querying, and reading compact project context.

agent-store

Use agent-store init once per project to create .agent-store/, install these skills, and add project instructions when AGENTS.md or CLAUDE.md already exists.

Core loop:

agent-store init
agent-store create task title="Write tests" status=pending
agent-store find 'kind=task and status=pending'
agent-store get <id>
agent-store ctx

Records have a kind plus arbitrary key=value fields. Use short IDs printed by mutation commands to retrieve or update specific records. Kinds and field names cannot contain whitespace, control characters, quotes, or =; kind and id are reserved field names (in queries, kind always addresses the record kind). Field values are unrestricted.

Queries join comparisons with and, or, not, and parentheses. Multiple bare query arguments are joined with an implicit and, so find kind=task status=pending means find 'kind=task and status=pending'. Comparisons support =, !=, <, <=, >, >=, and ~= (case-insensitive substring match, e.g. title~=login) over the record kind and fields. Quote comparison values that contain spaces (title='Write tests', single or double quotes; backslash escapes an embedded quote), use to match empty-string fields, and run bare (or ) to list every record in creation order, oldest first.