backpack-ontology 0.2.4 → 0.2.5

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.
Files changed (2) hide show
  1. package/README.md +36 -35
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,10 +1,10 @@
1
1
  # Backpack
2
2
 
3
- **Give your AI a memory it can actually use.** Backpack lets Claude remember what matters — your clients, your processes, your decisions — across every conversation.
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 — a relationship, a project decision, a workflow, a domain concept — Backpack saves it as a structured knowledge graph. Next time you ask, Claude already knows.
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,33 @@ No copy-pasting. No re-explaining. Your knowledge carries forward.
22
22
 
23
23
  ## Get started
24
24
 
25
- Tell Claude to set up Backpack:
25
+ ### Backpack Local (free, private, on your machine)
26
26
 
27
- > "Add backpack to this project"
27
+ ```bash
28
+ claude mcp add backpack -s user -- npx backpack-ontology
29
+ ```
28
30
 
29
- Claude will configure the MCP server for you. Restart Claude Code and you're ready.
31
+ The `-s user` flag installs globally so backpack is available in every project.
30
32
 
31
- Or set it up yourself — pick local or cloud:
33
+ ### Backpack App (free account, cloud sync)
32
34
 
33
- | Mode | Setup command |
34
- |---|---|
35
- | **Local** (free, private, on your machine) | `claude mcp add backpack -- npx backpack-ontology` |
36
- | **Backpack App** (free account, cloud sync) | `claude mcp add backpack-app -- npx backpack-app` |
35
+ ```bash
36
+ claude mcp add backpack-app -s user -- npx backpack-app
37
+ ```
38
+
39
+ Sync across devices, share with your team, and access the web-based graph visualizer at [app.backpackontology.com](https://app.backpackontology.com). On first run, a browser window opens for sign-in. After that, it's automatic.
37
40
 
38
- Backpack App syncs your knowledge across devices and gives you access to the web-based graph visualizer at [app.backpackontology.com](https://app.backpackontology.com). On first run, a browser window opens for sign-in — after that, it's automatic.
41
+ ### Switching from Backpack Local to Backpack App
42
+
43
+ Already using Backpack Local and want to move to the cloud? One command uploads everything:
44
+
45
+ > "Sync my backpack to the cloud"
46
+
47
+ Then swap your MCP config from `backpack` to `backpack-app` and you're done.
39
48
 
40
49
  ## What to say to Claude
41
50
 
42
- You don't need to learn commands or tools. Just talk to Claude naturally. Here's what you can do:
51
+ No commands to learn. Just talk naturally.
43
52
 
44
53
  ### Remember something
45
54
 
@@ -67,33 +76,25 @@ You don't need to learn commands or tools. Just talk to Claude naturally. Here's
67
76
 
68
77
  Claude will open the graph visualizer so you can explore your knowledge visually.
69
78
 
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
79
  ## What people use it for
79
80
 
80
- - **Client management** — keep track of accounts, contacts, contract details, and conversations across sessions
81
- - **Process documentation** — capture how things are done so Claude can help consistently
82
- - **Project knowledge** — architecture decisions, vendor relationships, compliance requirements
83
- - **Domain expertise** — industry terminology, regulatory frameworks, best practices
84
- - **Team onboarding** — new team members get Claude with your organization's context already loaded
81
+ - **Client management**: keep track of accounts, contacts, contract details, and conversations across sessions
82
+ - **Process documentation**: capture how things are done so Claude can help consistently every time
83
+ - **Project knowledge**: architecture decisions, vendor relationships, compliance requirements
84
+ - **Domain expertise**: industry terminology, regulatory frameworks, best practices
85
+ - **Team onboarding**: new team members get Claude with your organization's context already loaded
85
86
 
86
87
  ## How it works
87
88
 
88
- You have one backpack — it goes everywhere with you. Inside it, you organize knowledge into **ontologies**, each one 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 based on what you're discussing.
89
+ 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
90
 
90
91
  ## Data and privacy
91
92
 
92
- **Local mode**: 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
+ **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
94
 
94
- **Backpack App**: Your data is stored securely in our cloud infrastructure. See our [privacy policy](https://backpackontology.com/privacy) for details.
95
+ **Backpack App**: your data is stored securely in our cloud infrastructure. See our [privacy policy](https://backpackontology.com/privacy) for details.
95
96
 
96
- **Telemetry**: Backpack collects anonymous usage statistics (which tools are used, session duration) to improve the product. No content, names, or personal data is ever collected. Opt out with `DO_NOT_TRACK=1`.
97
+ **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
98
 
98
99
  ## Reference
99
100
 
@@ -101,27 +102,27 @@ You have one backpack — it goes everywhere with you. Inside it, you organize k
101
102
 
102
103
  | Command | What it does |
103
104
  |---|---|
104
- | `npx backpack-ontology` | Start the local MCP server |
105
- | `npx backpack-app` | Start the Backpack App MCP server (cloud) |
105
+ | `npx backpack-ontology` | Start the Backpack Local MCP server |
106
+ | `npx backpack-app` | Start the Backpack App MCP server |
106
107
  | `npx backpack-sync` | Upload local ontologies to Backpack App |
107
108
  | `npx backpack-viewer` | Open the graph visualizer (http://localhost:5173) |
108
109
  | `npx backpack-init` | Reinstall auto-capture hooks if removed |
109
110
 
110
111
  ### Tools
111
112
 
112
- Claude uses these automatically — you don't need to call them directly.
113
+ Claude uses these automatically. You don't need to call them directly.
113
114
 
114
115
  | What Claude does | How |
115
116
  |---|---|
116
117
  | See what's in the backpack | `backpack_list`, `backpack_describe` |
117
- | Add a new ontology to the backpack | `backpack_create` |
118
- | Find something in the backpack | `backpack_search`, `backpack_list_nodes` |
118
+ | Add a new ontology | `backpack_create` |
119
+ | Find something | `backpack_search`, `backpack_list_nodes` |
119
120
  | Get full details on an item | `backpack_get_node`, `backpack_get_neighbors` |
120
121
  | Add or update knowledge | `backpack_add_node`, `backpack_update_node`, `backpack_add_edge` |
121
122
  | Bulk import | `backpack_import_nodes` |
122
123
  | Clean up | `backpack_remove_node`, `backpack_remove_edge`, `backpack_delete` |
123
124
 
124
- ### Advanced configuration
125
+ ### Configuration
125
126
 
126
127
  | Variable | Effect |
127
128
  |---|---|
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "backpack-ontology",
3
- "version": "0.2.4",
3
+ "version": "0.2.5",
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",