aurelius (Blysspeak)

Aurelius

Self-hosted knowledge graph memory for developers and AI agents.

Quick Start · MCP Tools · Tasks · Graph UI · Русский

______________________________________________________________________

问题

每个AI会话都从零开始。你重新解释你的项目、你过去的决定、你的架构。任务分散在工具上，不记得做了什么。

与Aurelius： memory_status → 完整的项目背景。 task_view → 完整的工作历史。 memory_session → 两次会议之间没有什么损失。

______________________________________________________________________

快速开始

git clone https://github.com/Blysspeak/aurelius && cd aurelius
./install.sh

这将构建二进制文件，安装到 ~/.local/bin，配置Claude Code MCP服务器和挂钩，初始化数据库，并为项目建立索引。重新启动Claude Code，您就准备好了。

$ au --version
au 1.4.0

______________________________________________________________________

MCP工具（21）

Aurelius作为MCP服务器在stdio上运行。 install.sh 自动配置，或通过手动添加 /mcp 克劳德代码(command: au, args: ["mcp"]).

知识图谱

任务管理

网页搜索

______________________________________________________________________

任务管理

任务是 枢纽节点 在知识图谱中。你在任务上所做的一切——工作日志、决策、解决的问题——都会自动链接到它，创建一个完整的工作历史分支。

[Project]  [WorkLog: researched JWT libs]
                              ├──contains──> [WorkLog: implemented token refresh]
                              ├──contains──> [Decision: chose jsonwebtoken over jwt-simple]
                              ├──contains──> [Problem: token expiry race condition]
                              │                  └──solves── [Solution: added mutex lock]
                              ├──subtask_of──> [Task: Security epic]
                              └──blocks──> [Task: Deploy to prod]

状态生命周期

backlog → active → done
                 → blocked (with reason)
                 → cancelled

第一 task_log entry会自动激活积压任务。 task_update 自动跟踪时间戳。

验收标准

每个任务都可以有一个“完成定义”清单：

au task new "Implement auth" --project myapp --priority high \
  -c "JWT tokens work" \
  -c "Refresh flow tested" \
  -c "Rate limiting active"

集成

• memory_status 在会话开始时显示活动/阻止的任务
• memory_session 接受 tasks 用于将会话链接到任务的参数，将活动任务作为提示返回
• memory_recall 在搜索结果中包含任务
• task_view 通过BFS遍历聚合整个工作分支

______________________________________________________________________

命令行界面

au init                            # initialize database
au note "chose X over Y" -p app   # capture a decision → project
au context beacon                  # graph around a topic
au search "redis"                  # full-text search
au reindex                         # index current project
au view                            # open web graph UI
au touch path/to/file              # track file access
au export                          # export full graph as JSON
au mcp                             # start MCP server

任务命令

au task new "Title" -p myapp --priority high -c "Tests pass"
au task list --project myapp --status active,blocked
au task show                   # full details with work log branch
au task log  "Did X, Y, Z"    # record work (auto-activates)
au task done                   # mark complete
au task block  "waiting on API keys"
au task activate               # resume blocked task

______________________________________________________________________

Web用户界面

使用黑曜石风格的物理进行交互式知识图可视化。

au view            # opens browser at localhost:7175
au view -P 8080    # custom port
au view --no-open  # don't open browser

特征：

• 黑曜石风格物理学 --温和的力量，没有牵制，阻力自然会跟随邻居
• 项目枢纽节点 --连接会话、决策、问题、解决方案、任务的中心节点
• 清洁标签 --默认情况下，只有项目名称可见，悬停/选择时显示详细信息
• 项目筛选器 --按项目划分侧边栏范围（摘录自 [project-name] 标签前缀）
• 节点类型筛选器 --按决策、解决方案、问题、会话、项目、任务筛选
• 颜色编码的节点类型、节点详细信息面板、键盘快捷键（/、Esc、滚动）

______________________________________________________________________

会话生命周期

Session start  →  memory_status(project: "myapp")     # full context + active tasks
During work    →  task_log, memory_add, memory_relate  # track progress
Session end    →  memory_session(summary, decisions, problems_solved, tasks)

______________________________________________________________________

建筑

crates/
  aurelius-core/
    src/graph/       — crud.rs, search.rs, traverse.rs
    src/db.rs        — SQLite setup, migrations V1-V5
    src/models.rs    — Node, Edge, NodeType, Relation, MemoryKind
    src/indexer.rs   — Cargo.toml project indexer
  aurelius/
    src/mcp/
      handlers/      — status.rs, session.rs, crud.rs, search.rs, task.rs
      tools.rs       — MCP tool definitions (JSON schemas)
      mod.rs         — JSON-RPC 2.0 server
    src/search/
      brave.rs       — Brave Search API client
      cache.rs       — SQLite search cache with FTS5
  au/                — CLI + web UI server
ui/                  — React + TypeScript + Tailwind (graph visualization)
contrib/
  claude-code/       — session hooks (reindex, track edits)
  git-hooks/         — post-commit (captures decisions)

关键设计

• SQLite+WAL --并发阅读，单作者，本地优先
• FTS5 --索引标签+注释（不是原始JSON），通过触发器保持同步
• 5架构迁移 --V1核心，V2访问跟踪，V3索引+边缘去重，V4干净FTS，V5搜索缓存
• 批次BFS — WHERE id IN (...) 每个级别，而不是每个节点N+1
• 会话已结束 --SHA-256内容哈希（项目，摘要）
• 边缘去噪 --对（from_id，to_id，relation）的唯一约束
• 任务中心节点 --任务通过以下方式收集工作日志、决策、问题和解决方案 contains 边缘
• 问题生命周期 --未解决=没有具有的解决方案节点 solves 边缘
• 相关性排名 --访问计数提高了FTS结果
• 项目枢纽节点 --自动创建 memory_session 和 task_create，所有孩子通过链接 belongs_to
• 标签惯例 --子节点前缀 [project-name] description，项目节点使用纯名称

节点类型

project · task · work_log · decision · concept · problem · solution · session · crate · file · dependency · module · config · person · server · language

关系

belongs_to · contains · solves · subtask_of · blocks · depends_on · uses · caused_by · related_to · implements · configures · tracked_by · inspired_by · conflicts_with · supersedes · learned_from · imports · exports

______________________________________________________________________

挂钩（自动捕捉）

由自动安装 install.sh 进入 ~/.claude/settings.json.

______________________________________________________________________

路线图

• \[x\] v0.1——核心图、CLI、MCP服务器（8个工具）、项目索引器、web UI
• \[x\] v0.2--通配符搜索，转储分页
• \[x\] v0.3--会话内存、内存更新、增强内存添加
• \[x\] v0.4——智能召回、类型过滤搜索、问题生命周期、始终在线的图表
• \[x\] v0.5--查询优化、会话数据消除、无双重存储
• \[x\] v1.0--项目范围界定、批处理BFS、GC、边缘去重、FTS清理、模块化代码库、install.sh
• \[x\] v1.1-Web搜索（勇敢的API+SQLite缓存+图形集成）
• \[x\] v1.2--UI大修、项目范围链接、索引器修复
• \[x\] v1.3--黑曜石风格的图形物理、项目中心节点、会话自动链接
• \[x\] v1.4--任务管理（5个MCP工具+CLI）、工作分支、验收标准
• \[\]下一步——npm分发， au repair，上下文排序搜索，git日志连接器

______________________________________________________________________

许可证

麻省理工学院