Content
# **AG**rasandhan**Y**
From Sanskrit *agrasandhanī* (uh-gruh-sun-DHAA-nee) — the mythic ledger that records every action of every soul.
> **agy** — turn local notes into long-term memory for AI agents
**Status:** Alpha
## What is Agrasandhany (agy)
**Local, plain-text notes, written for yourself.** That's the whole idea — and **agy** turns them into memory your agents can search over.
- **Notes become memories** — each file, turned into searchable facts.
- **Folders become scopes** — `projects/backend/design.md` is tagged `projects/backend`, automatically.
- **Living summaries** — a summary of notes by folder, auto-refreshed as they change.
```
vault (files) → daemon (sync) → Hindsight (memory)
↑
MCP (agents)
```
The filesystem is the source of truth — **agy** mirrors your files; it's not a backup. Delete a note and its memory clears on the next sync.
*Under the hood:* **agy** embeds [Hindsight](https://hindsight.vectorize.io/) — a local retain/recall engine that extracts memories from your notes.
## Prerequisites
- [uv](https://docs.astral.sh/uv/getting-started/installation/)
- Linux or macOS (launchd auto-start requires macOS)
- An LLM provider — any [Hindsight-supported provider](https://hindsight.vectorize.io/developer/configuration) works.
## Install
```bash
git clone https://github.com/yugandhar-maram/agrasandhany.git ~/agrasandhany
cd ~/agrasandhany
```
## Quick start ([full guide](docs/usage.md))
```bash
# Configure LLM access
cp .env.example .env # defaults to Claude Code
export AGY_ENV_FILE=~/agrasandhany/.env
# Start the daemon
uv run agy daemon start
# Register a vault
uv run agy vault add ~/notes --name notes
# The daemon picks up new vaults automatically
```
## MCP Integration
This gives your agent access to your memories. Add to your agent's MCP config (e.g. `.claude/settings.json`):
```json
{
"mcpServers": {
"agrasandhany": {
"command": "uv",
"args": ["run", "--project", "~/agrasandhany", "python", "-m", "agy.mcp"],
"env": {
"AGY_ENV_FILE": "~/agrasandhany/.env",
"AGY_VAULT": "notes"
}
}
}
}
```
## Docs
- [usage](docs/usage.md) — setup, daemon, vault, MCP
- [configuration](docs/configuration.md) — env vars and vault settings
- [operations](docs/operations.md) — logs, jobs, troubleshooting
## License
[MIT](LICENSE)
---
*Dedicated to my wife — for the evenings, the weekends, and the patience. This wouldn't exist without the space you made for it.*
