# **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.*