user@argobox:~/journal/2026-01-28-tendril-goes-open-source
$ cat entry.md

Tendril Goes Open Source

โ—‹ NOT REVIEWED

Tendril Goes Open Source

Date: January 28, 2026 Decision: Extract knowledge graph as standalone library License: MIT Repo: ~/Development/tendril


The Decision

Iโ€™ve had a working knowledge graph in ArgoBox for months. Itโ€™s been through iterations - fullscreen mode, content preview, physics tuning.

Today I decided: this should be its own thing.


Why Open Source?

The selfish reason: I want other people to use this.

If Tendril becomes popular, ArgoBox gets exposure. Every blog using Tendril is a potential visitor. The library promotes the blog, the blog promotes the library.

The real reason: I built something that solves a problem. Why keep it locked in one blog?

Anyone who wants Obsidian-style graph visualization on the web should be able to have it. For free. Forever.


The Monorepo Structure

Created today:

tendril/
โ”œโ”€โ”€ packages/
โ”‚   โ”œโ”€โ”€ graph/      # @tendril/graph (core library)
โ”‚   โ””โ”€โ”€ astro/      # @tendril/astro (planned)
โ””โ”€โ”€ template/       # Full blog starter

The core library is framework-agnostic. Vanilla JavaScript wrapping Cytoscape.js.

The template is an Astro blog with the graph pre-configured. Clone and go.


The Workflow

The tricky part: I still develop in ArgoBox, but publish to Tendril.

Solution: A sync script.

  1. Make changes in ArgoBox (real data, real testing)
  2. Run npm run sync-tendril
  3. Script copies core files to the template
  4. Commit to Tendril repo

This keeps ArgoBox as the development lab while the public repo stays clean.


Naming

I almost called this โ€œArgoGraph.โ€ Terrible idea.

Went through options:

  • Synapse (every AI startup)
  • Graphite (monitoring tool)
  • Grove (too generic)
  • Mycelium (hard to spell)

Tendril won. Organic. Growing. Connecting.

โ€œIdeas that grow and connect.โ€

The tagline wrote itself.


Whatโ€™s Next

  1. Polish the core library
  2. Write documentation
  3. Publish to npm
  4. Submit to Astro themes

The physics are already good (after that 3-hour session). Now itโ€™s about packaging and publishing.


Thoughts

This is my first real open-source project.

Not counting utility scripts or dotfiles. An actual library that other people might use.

Scary. Exciting. Probably both.

Letโ€™s see who else wants their blog to feel like Obsidian.