stellavault 0.7.4 → 0.8.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +9 -4
- package/SKILL.md +50 -0
- package/dist/stellavault.js +1388 -621
- package/package.json +2 -1
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Stellavault
|
|
2
2
|
|
|
3
|
-
[](https://github.com/Evanciel/stellavault/actions/workflows/ci.yml) [](https://www.npmjs.com/package/stellavault) [](https://github.com/Evanciel/stellavault/actions/workflows/ci.yml) [](https://www.npmjs.com/package/stellavault) []()
|
|
4
4
|
|
|
5
5
|
> **Drop anything. It compiles itself into knowledge.** Claude remembers everything you know.
|
|
6
6
|
|
|
@@ -29,7 +29,8 @@ Self-compiling knowledge base with a full-featured editor, 3D neural graph, AI-p
|
|
|
29
29
|
|
|
30
30
|
```bash
|
|
31
31
|
npm install -g stellavault # or: npx stellavault
|
|
32
|
-
stellavault init # Interactive setup
|
|
32
|
+
stellavault init # Interactive setup (3 min): index vault + connect AI clients
|
|
33
|
+
stellavault setup # Connect to Claude Code/Desktop, Cursor, Windsurf, VS Code (one command)
|
|
33
34
|
stellavault graph # Launch 3D graph in browser
|
|
34
35
|
```
|
|
35
36
|
|
|
@@ -122,14 +123,18 @@ These features do **not exist** in Obsidian — even with plugins.
|
|
|
122
123
|
## MCP Integration (21 Tools)
|
|
123
124
|
|
|
124
125
|
```bash
|
|
126
|
+
stellavault setup # one command → Claude Code, Claude Desktop, Cursor, Windsurf, VS Code
|
|
127
|
+
# or, for Claude Code only:
|
|
125
128
|
claude mcp add stellavault -- stellavault serve
|
|
126
129
|
```
|
|
127
130
|
|
|
128
|
-
Claude can search, ask, draft, lint, and analyze your vault directly.
|
|
131
|
+
Claude can search, ask, draft, lint, and analyze your vault directly. Search
|
|
132
|
+
fuses **semantic + BM25 + entity-linking** — your `[[wikilinks]]`, tags, and
|
|
133
|
+
headings become retrieval signals — with session-adaptive reranking.
|
|
129
134
|
|
|
130
135
|
| Tool | What it does |
|
|
131
136
|
|------|-------------|
|
|
132
|
-
| `search` | Hybrid
|
|
137
|
+
| `search` | Hybrid semantic + BM25 + entity-linking, adaptive rerank |
|
|
133
138
|
| `ask` | Vault-grounded Q&A |
|
|
134
139
|
| `generate-draft` | AI drafts from your knowledge |
|
|
135
140
|
| `get-decay-status` | Memory decay report (FSRS) |
|
package/SKILL.md
ADDED
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: stellavault
|
|
3
|
+
description: >-
|
|
4
|
+
Search, recall, and reason over the user's personal knowledge base — their
|
|
5
|
+
Obsidian/Markdown vault — via the Stellavault MCP server. Use whenever the
|
|
6
|
+
user refers to their own notes, past decisions, or accumulated knowledge:
|
|
7
|
+
"search my notes", "what do I know about X", "what did I decide about Y",
|
|
8
|
+
"from my vault", "my second brain", "recall", "didn't I write about",
|
|
9
|
+
내 노트에서, 볼트에서 찾아, 예전에 정리한, 기억나, 내가 뭐라고 했더라,
|
|
10
|
+
ノートを検索, ボルトから, 私のメモ, 笔记中搜索, 我的知识库.
|
|
11
|
+
Do NOT use for general web knowledge or for files in the current repo.
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
# Stellavault — the user's second brain, inside Claude
|
|
15
|
+
|
|
16
|
+
Stellavault indexes the user's Obsidian/Markdown vault locally (vector + BM25 +
|
|
17
|
+
entity-linking hybrid search, fully on-device — no data leaves the machine) and
|
|
18
|
+
exposes it over MCP. When the user asks about *their own* knowledge, prefer these
|
|
19
|
+
tools over guessing or web search.
|
|
20
|
+
|
|
21
|
+
## When to use
|
|
22
|
+
|
|
23
|
+
- The user references their own notes, vault, or "second brain".
|
|
24
|
+
- They ask what they previously wrote, learned, or decided.
|
|
25
|
+
- They say "recall", "remind me", "didn't I note…", or use the Korean/JP/CN
|
|
26
|
+
equivalents in the description triggers.
|
|
27
|
+
- Before answering a personal/project question that their notes likely cover.
|
|
28
|
+
|
|
29
|
+
## Key MCP tools (server name: `stellavault`)
|
|
30
|
+
|
|
31
|
+
- **search** — hybrid retrieval (semantic + keyword + entity). Start here for
|
|
32
|
+
"find / what do I know about …".
|
|
33
|
+
- **ask** — retrieve + compose a grounded answer from the vault.
|
|
34
|
+
- **get-related** — neighbors of a note (knowledge-graph expansion).
|
|
35
|
+
- **list-topics** — tag/topic overview of the vault.
|
|
36
|
+
- **find-decisions** / **log-decision** — query or append the decision journal (ADRs).
|
|
37
|
+
- **get-decay-status** / **get-morning-brief** — what the user is forgetting (FSRS).
|
|
38
|
+
- **detect-gaps**, **get-evolution**, **generate-claude-md** — knowledge analysis.
|
|
39
|
+
|
|
40
|
+
## Setup (one time)
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
npm install -g stellavault
|
|
44
|
+
stellavault init # pick vault, index it, optionally connect clients
|
|
45
|
+
stellavault setup # or connect clients later (Claude Code/Desktop, Cursor, Windsurf, VS Code)
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
`setup` registers Stellavault as an MCP server in each detected client. Restart
|
|
49
|
+
the client afterward. Everything runs locally; embeddings use a local model, so
|
|
50
|
+
no API key is required and no note content is sent to any server.
|