About wikibonsai

A structured knowledge layer in plain text.

w

Published by

wikibonsai

Visit View Profile

README.md

View on GitHub

WikiBonsai

A knowledge bonsai wends through concepts in semantic space, like a melody winds through harmonies in music.

cite me!

⚠️ Please remember to backup all data and use version control.

WikiBonsai extends markdown with [[wiki]] syntaxes, semantic trees, structured attributes, and graph visualizations. These mechanics build a structured knowledge layer in plain text. The same conventions that help people organize what they know also give AI agents a way to read, write, and reason over that knowledge.

Plain text is our common ground.

Quick Start

You can get started immediately with the vscode extension, the CLI tool, or the agent skill.

For more details, check out the full guide on getting started.

How It Works

[[Wikirefs]] -- Link concepts with wiki-style syntax for quick associative linking (a.k.a. "wikilink", "bidirectional link", "internal link", etc.).
Semantic Trees -- Organize concepts into a unified "knowledge bonsai" that spans your collection of markdown files.
Structured Attributes -- Add clean, yaml-like :colon::attributes metadata (with built-in [[wikiref]] support).
Graph View -- See and interact with the "memory palace" that emerges from relationships across your notes.

These workflows define the "WikiBonsai" philosophy of knowledge architecture and may also facilitate the mapping of semantic space. This mapping may prove invaluable in building a better understanding of how neural nets work and furthering the development of interpretable, explainable AI.

Project Info

Docs

The documentation in this repository describes the philosophies, mechanics, and terminologies that are adopted throughout all of the WikiBonsai projects:

For Use:
- Getting Started
- Privacy and Security
For Dev:
For Lore:
For Input:
- Questions

And be sure to check out other writings for art, writing, memes, and more.

Repos

This project abides by the Unix Philosophy. Everything is modularized and implemented in such a way as to maximize re-use whether it be for the browser, desktop, mobile, or headset. It's about furthering structured knowledge tooling by building atop "standardization bedrock" instead of just creating a single application.

The following links point to repositories of the WikiBonsai project and are organized by stack depth. Projects toward the top are ready-to-use and meant for the end user, while projects toward the bottom are meant for developers to build with and integrate into other solutions.

Repo list

For Use:
- AI:
  - germinator: An AI-powered semantic seedling germinator that generates starter semantic mappings of concepts which are easily transplantable into one's own digital garden.
    - semtree-germ: An earlier version of the germinator that focused on semantic trees.
  - tree-trainer: An AI-powered tree trainer that generates syntax trees for sentence(s).
  - tendr-skill: A skill for AI agents to tend their knowledge base.
- Notes:
  - vscode-tendr: A VSCode extension for tending a WikiBonsai digital garden.
  - tendr-cli: A CLI tool for tending a markdown-based WikiBonsai digital garden.
  - garden-beds: A collection of starter WikiBonsai digital gardens -- includes starter markdown files and config files.
- SSG:
  - jekyll-garden: A jekyll template that can be imported as a gem or cloned as a template project.
  - jekyll-bloomz: An example setup to enable WikiBonsai workflows for a jekyll-based statically generated site (SSG).
  - astro-bloomz: An example setup to enable WikiBonsai workflows for an astro-based statically generated site (SSG).
  - eleventy-bloomz: An example setup to enable WikiBonsai workflows for eleventy-based static site generation (SSG).
For Dev:
- Markdown Parsers:
  - markdown-it-caml: A markdown-it plugin to enable :colon::attributes.
  - markdown-it-wikirefs: A markdown-it plugin to enable [[wikirefs]].
  - remark-caml: A remark plugin to enable :colon::attributes.
  - remark-wikirefs: A remark plugin to enable [[wikirefs]].
- Jekyll:
  - jekyll-graph: A jekyll plugin to generate graphs of blog content.
  - jekyll-semtree: A jekyll plugin to generate a semantic tree from index collections.
  - jekyll-wikirefs: A jekyll plugin to enable [[wikirefs]].
- Base:
  - almanac: A type system for markdown-based knowledge.
  - caml: Base utilities for Colon Attribute Markup Language (:colon::attributes).
  - caudex: An index to cache and store WikiBonsai relationships.
  - semtree: Base utilities for "semantic tree" or "knowledge bonsai" building in markdown.
  - treehouze: Generalized graph utilities with minor specialized features for visualizing WikiBonsai-enabled markdown-based knowledge collections.
  - trug: A config handler for WikiBonsai-style knowledge collections.
  - wikirefs: Base utilities for internal links ([[wikirefs]]).
- Spec:
  - caml-spec: Test suite for Colon Attribute Markup Language, CAML, (:colon::attributes) specification.
  - wikirefs-spec: Test suite for wikirefs ([[wikirefs]]) specification.

Foreword

Here's to making the road ahead a bit smoother for those that follow.

just keep tending...🪴

🇺🇸 Made in the USA 🦅 🐊