内容
# **阿格拉桑提**
源自梵语 *agrasandhanī*（uh-gruh-sun-DHAA-nee）—— 一种神话中的账本，记录着每个灵魂的每一次行动。
> **agy** — 将本地笔记转化为 AI 代理的长期记忆
**状态：** Alpha
## 什么是阿格拉桑提（agy）
**本地、纯文本笔记，为自己而写。** 就是这么简单 — 而 **agy** 将它们转化为您的代理可以搜索的记忆。
- **笔记变成记忆** — 每个文件，转化为可搜索的事实。
- **文件夹变成范围** — `projects/backend/design.md` 被自动标记为 `projects/backend`。
- **动态摘要** — 按文件夹整理的笔记摘要，当笔记变化时自动刷新。
```
vault（文件）→ daemon（同步）→ Hindsight（记忆）
↑
MCP（代理）
```
文件系统是真实的来源 — **agy** 镜像您的文件；它不是备份。删除笔记后，其记忆将在下一次同步时清除。
*在幕后：* **agy** 嵌入了 [Hindsight](https://hindsight.vectorize.io/) — 一个本地保留/回忆引擎，从您的笔记中提取记忆。
## 先决条件
- [uv](https://docs.astral.sh/uv/getting-started/installation/)
- Linux 或 macOS（launchd 自动启动需要 macOS）
- LLM 提供商 — 任何 [Hindsight 支持的提供商](https://hindsight.vectorize.io/developer/configuration) 都有效。
## 安装
```bash
git clone https://github.com/yugandhar-maram/agrasandhany.git ~/agrasandhany
cd ~/agrasandhany
```
## 快速开始（[完整指南](docs/usage.md)）
```bash
# 配置 LLM 访问
cp .env.example .env # 默认使用 Claude Code
export AGY_ENV_FILE=~/agrasandhany/.env
# 启动守护进程
uv run agy daemon start
# 注册 vault
uv run agy vault add ~/notes --name notes
# 守护进程会自动发现新的 vault
```
## MCP 集成
这使您的代理可以访问您的记忆。在代理的 MCP 配置中添加（例如 `.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.md) — 设置、守护进程、vault、MCP
- [配置](docs/configuration.md) — 环境变量和 vault 设置
- [操作](docs/operations.md) — 日志、作业、故障排除
## 许可证
[MIT](LICENSE)
---
*献给我的妻子 — 为了那些傍晚、周末和耐心。如果没有你为它创造的空间，这一切都不会存在。*
