AKMS mode¶
AKMS mode connects Logic-Loom to AKMS, the Adaptive Knowledge Management System: a graph of reusable knowledge nodes (concepts, derivations, pitfalls) built from your sources. Logic-Loom uses it to group papers into batches, generate and review nodes, explore the graph and compile learning material.
It needs the akms extra, which release builds include. No AKMS source checkout is
needed; everything runs from the installed packages and your AKMS workspace.
Tabs¶
| Tab | What it does |
|---|---|
| Overview | Readiness of each AKMS feature, with setup hints |
| Batches | Your batch definitions, plus starter batches seeded on first run |
| Picker | Assign papers to batches and NotebookLM notebooks, then generate and validate nodes. Lists every batch from the Batches tab and picks up changes without a restart |
| Nodes | Browse, review and promote generated nodes; established nodes are badged separately from drafts. Open in Editor uses the editor command from zsum ▸ Settings ▸ Nodes Review, or your system's default app when none is set, and says which it used |
| Graph | Read-only graph explorer (below) |
| Learn | Compile graph slices into learning material |
| Prompts | The prompt library: bundled defaults, your variants and active profiles |
| Workflows | The workflow library: bundled and your own workflow definitions |
| Runs | Every node-generation and workflow run, with outputs and metadata |
| Settings | The LLM provider chooser, workspace location and Claude assets |
Node generation¶
From the Picker, three workflows run as background jobs with streamed logs:
- Generate (Claude): through the Claude Code CLI, optionally grounded in NotebookLM
through
nlm_mcp_url. - Generate (NLM): directly through NotebookLM.
- Validate nodes: checks generated nodes against their source notebooks.
Each run records the exact prompts, workflow and inputs it used under
<akms_workspace>/runs/<run_id>/, so it can be compared or rerun.
Curated library and starter batches¶
Release builds ship a read-only library of established nodes, shown in the graph next to your own with their provenance. You can copy an established node into your vault to edit it, or report an error in one. Starter batches are a separate, editable seed pack: they are yours to run and change, and never mixed into the established library.
Graph¶
The Graph tab is read-only. It compiles the AKMS graph into Logic-Loom's cache
(~/.cache/logic-loom/graph/graph.json) and never writes to your source vault.
- Refresh compiles a fresh graph.
- Filtered view narrows by text, domain, status, tag and node origin.
- Ego view centres on one node with a chosen depth and direction.
- Cluster view slices by tag or domain.
- The inspector shows a node's metadata and edges, with links to open it in Nodes or your editor, or send the selection to Learn.
The graph source vault is resolved in this order:
akms_global_vault, if set<akms_repo>/Packages/Nodes_Vault, only when a developer checkout is configured- the
AKMS_GLOBAL_VAULTenvironment variable ~/.claude/akms/nodes
If none of them exists, the Graph tab shows a setup message.
Learn¶
Learn compiles a slice of the graph into a Learning Source Packet: a reproducible
artifact with a reading order, per-node sections, pitfalls, assessment items and code
links, which it then exports in the format you pick. The available modes and exporters
come from the installed akms-learn; modes that need an LLM are disabled until a provider
is configured. The History list under the form keeps your latest 50 compiles on this
computer, across restarts. See the akms-learn docs.
More on AKMS¶
The AKMS documentation covers the graph model, node format, the batch picker and the node-generation tools in depth.