yaps-memoryv1.0.2

A knowledge worker uses the skill to search their Yaps vault for past voice dictations and notes related to a topic, retrieving only relevant hits with vault get. They cite titles and paths when summarizing findings. This avoids scanning the entire vault and keeps context focused.

A consultant working on a client engagement uses a stable project scope, inspecting command help for --project and applying it consistently. They run scoped lexical search and retrieve project materials only after resolving project ambiguity. Older Yaps versions require Projects/<project>/ paths and matching project:<project> tags.

A user explicitly asks the agent to save a new note into the Yaps vault. The agent first searches for duplicates, then creates the note via vault create with a markdown file. Before any update, it fetches the current note and uses the expected-updated-at timestamp guard to prevent stale writes.

A user requests restoring history, pinning a note, or renaming and tagging a note. Each operation requires explicit corresponding user intent and inspection of relevant command help. Delete operations only proceed with the exact note and confirm flag, never editing vault files directly.

A new user installs Yaps and signs in, then the agent explains the distinction between this CLI-based package and an MCP server or Yaps Agent Access enrollment. The agent checks vault status without reading note contents, and confirms required Yaps version 2.3.124 or newer. If an existing MCP connection denies access, the agent stops.

The skill operates as a local CLI tool that connects an AI agent host to a user's Yaps memory vault, enabling semantic and lexical note search plus controlled capture. It relies on the host's local command permissions rather than installing an MCP server. Revenue comes from Yaps subscriptions and premium vault features.

Teams deploy the skill to let agents search project-scoped notes and dictations within a shared Yaps vault, keeping operations scoped and auditable. The enforced write guards and delete confirmations reduce accidental data loss. Organizations pay per-seat or per-workspace for advanced governance and project scoping.

The skill acts as a bridge that lets third-party AI agent platforms offer Yaps memory capabilities to their users without building native integrations. It respects existing access policies and avoids bypassing denials. Revenue is generated through API/CLI access partnerships and usage-based fees.