name	yaad
description	yaad is a simple local memory engine for humans and agents. Use it to remember anything worth keeping across sessions, and to recall it later in natural language. Invoke when starting work to load prior context, when something is worth saving, or when the user asks about something from the past.
argument-hint	[query] or [add <content>] or [add <content> --remind 'when']
allowed-tools	Bash

yaad is a CLI-based AI memory engine — the simplest way to save anything and retrieve it later in natural language. One command to store, one to recall. Everything stays on the user's machine, no cloud, no accounts.

Check yaad is installed

which yaad

If not found, tell the user to install it first:

curl -fsSL https://yaad.knl.co.in/install.sh | bash

Then stop — do not proceed until yaad is available.

Commands

Save a memory

yaad add "<content>"

Save with a reminder

yaad add "<content>" --remind "in 30 minutes"
yaad add "<content>" --remind "tomorrow 9am"
yaad add "<content>" --remind "sunday 9pm"
yaad add "<content>" --remind "in 2 hours"

Check for due reminders

yaad check

Run this to surface any reminders that are currently due. Use it at the start of a session or any time you want to see what's pending.

Recall with natural language

yaad ask "<question>"

When to save

Save proactively when you encounter:

A command that solved a non-obvious problem
A port, hostname, or infrastructure detail the user will look up again
A decision made about architecture, approach, or tooling
A URL for docs or an API being actively used
A time-based reminder the user sets
Any fact the user explicitly says they want to remember

Writing good memories

Put all context directly in the content — the AI embeds the full string, so searchable context belongs there:

# good — self-contained, findable later
yaad add "staging db is postgres on port 5433"
yaad add "prod uses nginx, config at /etc/nginx/sites-enabled/app"
yaad add "API rate limit is 100 req/min per token"
yaad add "deploy checklist: run migrations, restart workers, clear cache"
yaad add "standup at 10am" --remind "tomorrow 9:45am"

# avoid — no context, won't recall well
yaad add "port 5433"
yaad add "check this later"

Memory-first instinct

Before reaching for a tool (filesystem search, web search, re-asking the user), ask yourself: could this already be in memory?

If the answer is "maybe" — ask yaad first. It's cheaper than a search and respects what the user has already told you.

yaad ask "<what you're looking for>"

After finding or figuring something out that the user will likely need again, save it without being asked.

When to recall

At the start of a session, to surface relevant prior context
Whenever the user asks about something they may have mentioned before
Before any search — file, web, or otherwise — for facts, paths, configs, or decisions

Checking reminders at session start

Run this at the beginning of every session:

yaad check

If anything is due, surface it to the user immediately before proceeding.

# good — self-contained, findable later yaad add "staging db is postgres on port 5433" yaad add "prod uses nginx, config at /etc/nginx/sites-enabled/app" yaad add "API rate limit is 100 req/min per token" yaad add "deploy checklist: run migrations, restart workers, clear cache" yaad add "standup at 10am" --remind "tomorrow 9:45am" # avoid — no context, won't recall well yaad add "port 5433" yaad add "check this later"