glassbrain 0.1.3 → 0.2.0-alpha.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 CHANGED
@@ -5,12 +5,9 @@
5
5
  Your agent keeps knowledge graphs: of your code, your docs, its research, its own plans. glassbrain
6
6
  lets you read one at a glance, and when the agent learns something, shows you exactly what changed.
7
7
 
8
- ![A product's docs and app turned into a graph of user stories in four agent steps](https://raw.githubusercontent.com/voidixyn/glassbrain/main/docs/media/grow.gif)
8
+ ![The prompt suffix in an agent's input box: … Tell me all you know, using `npx glassbrain`](https://raw.githubusercontent.com/voidixyn/glassbrain/main/docs/media/composer.jpg)
9
9
 
10
- ```bash
11
- npx glassbrain kg/ # open a graph in the browser (kg/ = JSON files, or one folder per version)
12
- npx glassbrain diff HEAD~1 kg/ # what changed in the last commit
13
- ```
10
+ ![A product's docs and app turned into a graph of user stories in four agent steps](https://raw.githubusercontent.com/voidixyn/glassbrain/main/docs/media/grow.gif)
14
11
 
15
12
  [**Live demo**](https://voidixyn.github.io/glassbrain/) · [Agents write it](#1-a-brain-your-agent-can-write) ·
16
13
  [Humans read it](#2-read-it-like-a-brain-scan) · [Every brain](#3-every-brain-on-demand) ·
@@ -155,7 +152,7 @@ Each tool's own notion of "inside" becomes the structure; everything else become
155
152
 
156
153
  ## 4. Try it yourself
157
154
 
158
- Three ways to try glassbrain—pick whichever fits.
155
+ Four ways to try glassbrain—pick whichever fits.
159
156
 
160
157
  - **Demo.** Explore the [live demo](https://voidixyn.github.io/glassbrain/).
161
158
 
@@ -171,6 +168,13 @@ Three ways to try glassbrain—pick whichever fits.
171
168
 
172
169
  > Turn these research notes into a graph of ideas, evidence, and open questions, using `npx glassbrain`.
173
170
 
171
+ - **CLI.** Open or diff a graph you already have:
172
+
173
+ ```bash
174
+ npx glassbrain kg/ # open a graph in the browser (kg/ = JSON files, or one folder per version)
175
+ npx glassbrain diff HEAD~1 kg/ # what changed in the last commit
176
+ ```
177
+
174
178
  - **React.** Embed the graph component in your own app:
175
179
 
176
180
  ```bash
@@ -187,18 +191,6 @@ Three ways to try glassbrain—pick whichever fits.
187
191
 
188
192
  Customize colors, layers, fields and editing in [the guide](https://github.com/voidixyn/glassbrain/blob/main/docs/guide.md).
189
193
 
190
- ## Questions
191
-
192
- **Is this a graph database or a graph builder?** Neither. It is the screen: something else
193
- (your agent, Graphify, a script) builds the graph; glassbrain shows it and its changes.
194
-
195
- **How is it different from Graphify's or Understand-Anything's own viewer?** Those come with
196
- their extractors. glassbrain opens their output too, and adds stable structure and version
197
- comparison. Use both.
198
-
199
- **Can I edit the graph by hand?** Yes, in your app (`onEdit`) or in the demo. Edits are a patch of
200
- small operations, so they can be replayed after the agent regenerates the graph.
201
-
202
194
  ## Docs
203
195
 
204
196
  - [Guide](https://github.com/voidixyn/glassbrain/blob/main/docs/guide.md): the library: profiles, colors, positions, theming, editing.