backpack-ontology 0.2.4 → 0.2.6
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 +40 -35
- package/package.json +4 -3
package/README.md
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
# Backpack
|
|
2
2
|
|
|
3
|
-
**
|
|
3
|
+
**Carry your knowledge forward.** Backpack lets Claude remember what matters: your clients, your processes, your decisions. Knowledge that travels with you.
|
|
4
4
|
|
|
5
5
|
## What it does
|
|
6
6
|
|
|
7
|
-
When you're working with Claude and something worth remembering comes up
|
|
7
|
+
When you're working with Claude and something worth remembering comes up, Backpack saves it as a structured knowledge graph. Next time you ask, Claude already knows.
|
|
8
8
|
|
|
9
9
|
```
|
|
10
10
|
You: "We just signed Acme Corp, they're on the Enterprise tier, main contact is Sarah Chen"
|
|
@@ -22,24 +22,37 @@ No copy-pasting. No re-explaining. Your knowledge carries forward.
|
|
|
22
22
|
|
|
23
23
|
## Get started
|
|
24
24
|
|
|
25
|
-
|
|
25
|
+
### Recommended: Backpack App (free cloud account)
|
|
26
26
|
|
|
27
|
-
|
|
27
|
+
Sign up for a free account at [app.backpackontology.com](https://app.backpackontology.com), then add Backpack to Claude Code:
|
|
28
28
|
|
|
29
|
-
|
|
29
|
+
```bash
|
|
30
|
+
claude mcp add backpack-app -s user -- npx backpack-app
|
|
31
|
+
```
|
|
30
32
|
|
|
31
|
-
|
|
33
|
+
Your knowledge syncs across devices, you can share with your team, and you get access to the web-based graph visualizer. On first run, a browser window opens for sign-in. After that, it's automatic.
|
|
32
34
|
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
35
|
+
### Backpack Local (offline, private)
|
|
36
|
+
|
|
37
|
+
Prefer to keep everything on your machine? No account needed:
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
claude mcp add backpack-local -s user -- npx backpack-local
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
You can always move to Backpack App later by telling Claude "sync my backpack to the cloud".
|
|
37
44
|
|
|
38
|
-
|
|
45
|
+
### Switching from Backpack Local to Backpack App
|
|
46
|
+
|
|
47
|
+
Already using Backpack Local and want to move to the cloud? One command uploads everything:
|
|
48
|
+
|
|
49
|
+
> "Sync my backpack to the cloud"
|
|
50
|
+
|
|
51
|
+
Then swap your MCP config from `backpack` to `backpack-app` and you're done.
|
|
39
52
|
|
|
40
53
|
## What to say to Claude
|
|
41
54
|
|
|
42
|
-
|
|
55
|
+
No commands to learn. Just talk naturally.
|
|
43
56
|
|
|
44
57
|
### Remember something
|
|
45
58
|
|
|
@@ -67,33 +80,25 @@ You don't need to learn commands or tools. Just talk to Claude naturally. Here's
|
|
|
67
80
|
|
|
68
81
|
Claude will open the graph visualizer so you can explore your knowledge visually.
|
|
69
82
|
|
|
70
|
-
### Move to the cloud
|
|
71
|
-
|
|
72
|
-
> "Sync my backpack to the cloud"
|
|
73
|
-
|
|
74
|
-
> "Upload my local ontologies to Backpack App"
|
|
75
|
-
|
|
76
|
-
Claude will migrate your local knowledge to Backpack App so you can access it from any device.
|
|
77
|
-
|
|
78
83
|
## What people use it for
|
|
79
84
|
|
|
80
|
-
- **Client management
|
|
81
|
-
- **Process documentation
|
|
82
|
-
- **Project knowledge
|
|
83
|
-
- **Domain expertise
|
|
84
|
-
- **Team onboarding
|
|
85
|
+
- **Client management**: keep track of accounts, contacts, contract details, and conversations across sessions
|
|
86
|
+
- **Process documentation**: capture how things are done so Claude can help consistently every time
|
|
87
|
+
- **Project knowledge**: architecture decisions, vendor relationships, compliance requirements
|
|
88
|
+
- **Domain expertise**: industry terminology, regulatory frameworks, best practices
|
|
89
|
+
- **Team onboarding**: new team members get Claude with your organization's context already loaded
|
|
85
90
|
|
|
86
91
|
## How it works
|
|
87
92
|
|
|
88
|
-
You have one backpack
|
|
93
|
+
You have one backpack. It goes everywhere with you. Inside it, you organize knowledge into **ontologies**, each covering a different topic (clients, processes, compliance, etc.). Within each ontology, information is stored as things connected by relationships. You don't need to think about the structure. Claude handles it automatically.
|
|
89
94
|
|
|
90
95
|
## Data and privacy
|
|
91
96
|
|
|
92
|
-
**Local
|
|
97
|
+
**Backpack Local**: your data is stored as readable JSON files on your computer at `~/.local/share/backpack/ontologies/`. You can inspect, edit, back up, or version-control these files directly.
|
|
93
98
|
|
|
94
|
-
**Backpack App**:
|
|
99
|
+
**Backpack App**: your data is stored securely in our cloud infrastructure. See our [privacy policy](https://backpackontology.com/privacy) for details.
|
|
95
100
|
|
|
96
|
-
**Telemetry**: Backpack collects anonymous usage statistics (
|
|
101
|
+
**Telemetry**: Backpack collects anonymous usage statistics (tool counts, session duration) to improve the product. No content, names, or personal data is ever collected. Opt out with `DO_NOT_TRACK=1`.
|
|
97
102
|
|
|
98
103
|
## Reference
|
|
99
104
|
|
|
@@ -101,27 +106,27 @@ You have one backpack — it goes everywhere with you. Inside it, you organize k
|
|
|
101
106
|
|
|
102
107
|
| Command | What it does |
|
|
103
108
|
|---|---|
|
|
104
|
-
| `npx backpack-
|
|
105
|
-
| `npx backpack-app` | Start the Backpack App MCP server
|
|
109
|
+
| `npx backpack-local` | Start the Backpack Local MCP server |
|
|
110
|
+
| `npx backpack-app` | Start the Backpack App MCP server |
|
|
106
111
|
| `npx backpack-sync` | Upload local ontologies to Backpack App |
|
|
107
112
|
| `npx backpack-viewer` | Open the graph visualizer (http://localhost:5173) |
|
|
108
113
|
| `npx backpack-init` | Reinstall auto-capture hooks if removed |
|
|
109
114
|
|
|
110
115
|
### Tools
|
|
111
116
|
|
|
112
|
-
Claude uses these automatically
|
|
117
|
+
Claude uses these automatically. You don't need to call them directly.
|
|
113
118
|
|
|
114
119
|
| What Claude does | How |
|
|
115
120
|
|---|---|
|
|
116
121
|
| See what's in the backpack | `backpack_list`, `backpack_describe` |
|
|
117
|
-
| Add a new ontology
|
|
118
|
-
| Find something
|
|
122
|
+
| Add a new ontology | `backpack_create` |
|
|
123
|
+
| Find something | `backpack_search`, `backpack_list_nodes` |
|
|
119
124
|
| Get full details on an item | `backpack_get_node`, `backpack_get_neighbors` |
|
|
120
125
|
| Add or update knowledge | `backpack_add_node`, `backpack_update_node`, `backpack_add_edge` |
|
|
121
126
|
| Bulk import | `backpack_import_nodes` |
|
|
122
127
|
| Clean up | `backpack_remove_node`, `backpack_remove_edge`, `backpack_delete` |
|
|
123
128
|
|
|
124
|
-
###
|
|
129
|
+
### Configuration
|
|
125
130
|
|
|
126
131
|
| Variable | Effect |
|
|
127
132
|
|---|---|
|
package/package.json
CHANGED
|
@@ -1,15 +1,16 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "backpack-ontology",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.6",
|
|
4
4
|
"description": "A persistent ontology engine for Claude Code via MCP — progressive discovery of structured knowledge graphs",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"author": "Noah Irzinger",
|
|
7
7
|
"type": "module",
|
|
8
8
|
"bin": {
|
|
9
|
-
"backpack": "./dist/bin/backpack.js",
|
|
9
|
+
"backpack-local": "./dist/bin/backpack.js",
|
|
10
10
|
"backpack-app": "./dist/bin/backpack-app.js",
|
|
11
11
|
"backpack-sync": "./dist/bin/backpack-sync.js",
|
|
12
|
-
"backpack-init": "./dist/bin/init.js"
|
|
12
|
+
"backpack-init": "./dist/bin/init.js",
|
|
13
|
+
"backpack": "./dist/bin/backpack.js"
|
|
13
14
|
},
|
|
14
15
|
"main": "./dist/index.js",
|
|
15
16
|
"types": "./dist/index.d.ts",
|