Vesti Memory

Recall past AI coding sessions and file touches captured by VESTI. Use when the user references earlier work ("继续上次…", "之前我们…"), asks which local file or project contained prior work, starts a session in a tracked project, merges work across projects or branches, or needs a decision made in missing context. Provides project context, file-level lookup, and progressive retrieval from session index to selected full turns.

395 stars 1 forksProductivity & Notes Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add firefly-hefeng/VESTI-SKILLS

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add firefly-hefeng/VESTI-SKILLS --skill vesti-memory
Manual install
git clone --depth 1 https://github.com/firefly-hefeng/VESTI-SKILLS.git /tmp/VESTI-SKILLS
mkdir -p ~/.claude/skills
cp -r /tmp/VESTI-SKILLS/packages/vesti-memory/assets/vesti-memory ~/.claude/skills/vesti-memory

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# VESTI Memory — 项目上下文、文件定位与渐进检索

VESTI 的独立捕获服务在本机持续采集你与各 AI coding agent 的历史会话(来源支持时包括工具调用、子代理和文件改动),并以只读 MCP server 暴露检索接口。桌面端不是运行依赖;安装包会为目标数据库启动单写者捕获服务,多个支持 MCP 的客户端共享同一份本地记忆。

## 会话开始:先拉项目上下文

处于已跟踪项目时,**先调一次 `vesti_get_project_context`** 再动手,不要向用户重复索要背景:

- **vesti_get_project_context(paths?)** — 项目上下文包。每个路径返回最近会话、确定性活跃文件时间线,以及数据库中已有的 L0 状态卡、L2 维护简报和未决问题;尚未生成的摘要层可能为空,不影响继续检索原始会话与文件记录。
  - `paths[0]` 传你的**当前工作目录**;不传时默认最近活跃的项目。
  - **合并/跨项目任务**:一次传入多个项目路径,响应附带 `cross_project`——共享文件、共享主题、会话时间交叠,直接支撑"基于几个分支开合并项目"。
  - 路径出现在 `unmatched_paths` = 该项目未被 VESTI 跟踪(hints 里附已知项目列表),此后按无记忆处理,不要再反复重试。
  - 拿到上下文包后仍有缺口,再走下面的三层检索。

## 需要定位文件时:先查文件级记忆

- 用户问“上次 OAuth 改在哪个文件”“填写之前做过的 BP”或需要把历史工作落到当前代码时,先调用 **`vesti_search_files(query, topK=10)`**。
- 把返回的 `path`、`projects`、`last_touched` 和 backing sessions 当作历史证据;先确认项目范围,再用当前 Agent 的文件系统工具检查路径是否仍存在并读取最新内容。
- 该工具搜索的是 VESTI 记录的历史文件触碰,不搜索当前磁盘内容。用户问“当前目录里有没有某文件”时,直接使用文件系统搜索。
- 工具列表中没有 `vesti_search_files` 时,说明 MCP 版本较旧;退回 `vesti_search(文件名/主题)` → `vesti_timeline` → `vesti_get_turns`,并把推断出的路径标为待核实。

## 需要历史细节时:三层渐进披露

按以下顺序逐层缩小范围、控制返回量,**不要跳过层级直接拉全文**:

1. **vesti_search(query, topK=8)** — 会话级索引。返回 session_id、标题、平台、项目路径、时间、digest 一句话、关键主题、命中片段与 `confidence`。
   - 查询用**名词/文件名/决策关键词**,中英文皆可(底层 trigram FTS)。
   - `confidence:"low"` 的结果只作线索,**不要当作事实**;换关键词重试或明确告诉用户"记忆中没有找到"。
2. **vesti_timeline(session_id, around_turn?)** — 单会话 turn 大纲(序号/时间/用户意图一行/工具数/token)。用它定位需要哪几轮,不要盲取。
Read the full skill on GitHub

Details

Skill name
vesti-memory
Path
packages/vesti-memory/assets/vesti-memory/SKILL.md
License
MIT
Repo updated
20 September 2026

FAQ

What does the Vesti Memory skill do?

Recall past AI coding sessions and file touches captured by VESTI. Use when the user references earlier work ("继续上次…", "之前我们…"), asks which local file or project contained prior work, starts a session in a tracked project, merges work across projects or branches, or needs a decision made in missing context. Provides project context, file-level lookup, and progressive retrieval from session index to selected full turns.

How do I install the Vesti Memory skill?

Claude Code plugin: /plugin marketplace add firefly-hefeng/VESTI-SKILLS. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Vesti Memory popular?

It lives in firefly-hefeng/VESTI-SKILLS, which has 395 GitHub stars and 1 forks.

Related skills

Vesti Handoff

395

firefly-hefeng/VESTI-SKILLS

Produce a schema-based work handoff when transferring a task to another AI or session, compacting context, switching tools, generating a handoff, or preparing for /compact. Require the receiving agent to re-run the latest verification before trusting the handoff. The V2 format aligns with the VESTI-APP RelayPackV2 schema.

AI, LLMs & Agents

Skill Diet

260

nicobailon/skill-diet

Keep agent skills lean and correct. Use before editing an existing skill, such as adding a lesson; when a code change touches names or behavior a skill describes; and to put a skill on a full diet when it is large, loads detail most tasks never use, or has drifted from the tool it teaches.

Productivity & Notes10

Sbtd Workflow Onboard

559

KunoLu/640-skills

Checks, installs, resets, or explicitly upgrades and verifies selected SBTD workflow Skills, AGENTS and host configuration domains; plans and applies authorized legacy migrations and recovery; reconciles interrupted migration deployment evidence from current state; routes separately confirmed legacy cleanup and local Dashboard launch via "sbtd dashboard" or "sbtd ui".

Productivity & Notes13

Cicd Automation Workflow Automate

514

Dokhacgiakhoa/Agent-Skills-4-Vibe-Coding-CLI

You are a workflow automation expert specializing in creating efficient CI/CD pipelines, GitHub Actions workflows, and automated development processes. Design automation that reduces manual work, improves consistency, and accelerates delivery while maintaining quality and security.

Productivity & Notes146

Sbtd Task

559

KunoLu/640-skills

Use for SBTD task execution and continuation, explicit default/lite/strict mode selection, task records and status changes, cross-session recovery, and task handoffs. Load strict gates only for strict tasks; ordinary questions and read-only work do not create task files.

Productivity & Notes13

Clerk Auth

514

Dokhacgiakhoa/Agent-Skills-4-Vibe-Coding-CLI

Expert patterns for Clerk auth implementation, middleware, organizations, webhooks, and user sync Use when: adding authentication, clerk auth, user authentication, sign in, sign up.

Productivity & Notes146

Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.