{"id":13928783,"url":"https://github.com/wikibonsai/wikibonsai","last_synced_at":"2025-04-09T16:17:47.403Z","repository":{"id":171360167,"uuid":"608385269","full_name":"wikibonsai/wikibonsai","owner":"wikibonsai","description":"A jungle gym for thought with an API for the mind.","archived":false,"fork":false,"pushed_at":"2025-01-16T16:26:35.000Z","size":39622,"stargazers_count":77,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-09T16:17:40.507Z","etag":null,"topics":["bidirectional-link","digital-garden","exocortex","graph","hierarchy","knowledge-base","knowledge-bonsai","markdown","note-taking","ontology","personal-knowledge-management","personal-wiki","pkm","second-brain","semantic-tree","taxonomy","wikibonsai","wikilink","wikiref","zettelkasten"],"latest_commit_sha":null,"homepage":"https://wikibonsai.io","language":"Svelte","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wikibonsai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"docs/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":"CITATION.bib","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-03-01T22:53:04.000Z","updated_at":"2025-03-20T23:54:34.000Z","dependencies_parsed_at":null,"dependency_job_id":"ec55b869-a37f-4831-a280-074eaeda7a75","html_url":"https://github.com/wikibonsai/wikibonsai","commit_stats":{"total_commits":82,"total_committers":3,"mean_commits":"27.333333333333332","dds":"0.18292682926829273","last_synced_commit":"1c5657820e8ecef39f380c8ab24965bdc96c70ed"},"previous_names":["wikibonsai/wikibonsai"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wikibonsai%2Fwikibonsai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wikibonsai%2Fwikibonsai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wikibonsai%2Fwikibonsai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wikibonsai%2Fwikibonsai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wikibonsai","download_url":"https://codeload.github.com/wikibonsai/wikibonsai/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248065282,"owners_count":21041872,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bidirectional-link","digital-garden","exocortex","graph","hierarchy","knowledge-base","knowledge-bonsai","markdown","note-taking","ontology","personal-knowledge-management","personal-wiki","pkm","second-brain","semantic-tree","taxonomy","wikibonsai","wikilink","wikiref","zettelkasten"],"created_at":"2024-08-07T18:01:44.010Z","updated_at":"2025-04-09T16:17:47.384Z","avatar_url":"https://github.com/wikibonsai.png","language":"Svelte","funding_links":[],"categories":["markdown"],"sub_categories":[],"readme":"# WikiBonsai\n\n[![A WikiBonsai Project](https://img.shields.io/badge/%F0%9F%8E%8B-A%20WikiBonsai%20Project-brightgreen)](https://github.com/wikibonsai/wikibonsai)\n\n\u003e A knowledge bonsai wends through concepts in semantic space, like a melody winds through harmonies in music.\n\n###### [cite me!][wibomd-doc-cite-this]\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./static/wikibonsai.svg\" width=\"35%\" height=\"35%\"/\u003e\n\u003c/p\u003e\n\n\u003e ⚠️ Please remember to backup all data and use version control.\n\nThe WikiBonsai project[^ai] transforms a collection of markdown files into a text-based, easy-to-navigate [jungle gym for thought][wibomd-doc-philosophy--a-jungle-gym-for-thought][^mind] with an [API for the mind][wibomd-doc-design--an-api-for-the-mind][^mixed-metaphors]. This is accomplished by enabling personal knowledge management (PKM) workflows that rely on `[[wiki]]` syntaxes, \"semantic trees\" or \"knowledge bonsais\", and data visualizations that are viewable on screens or in augmented/virtual reality.\n\nThis project is about strategically implementing and open-sourcing functionality that will benefit the most users and developers across the digital ecosystem. Thus, it abides by the [Unix Philosophy][art-unix-phil]: 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 the state of PKM as a whole by building atop \"[standardization bedrock][wibomd-doc-design--drilling-down-to-standardization-bedrock]\" instead of just creating a single application.\n\nFurther, these workflows may also facilitate the mapping of [semantic space][wibomd-doc-design--semantic-space] which could prove an invaluable resource in building a better understanding of how neural nets work and furthering the development of interpretable, explainable AI.\n\nOnly time will tell how far this path may [go][wibomd-doc-philosophy--finding-free-will].\n\n## Notable Workflows\n\nThese are the workflows the WikiBonsai project enables for markdown-based collections of notes:\n\n1. Expanded [`[[wikirefs]]`][wibomd-repo-wikirefs] syntax for quick associative linking (a.k.a. \"wikilink\", \"bidirectional link\", \"[internal link][mediawiki-internal-link]\", etc.).\n2. [Mechanics][wibomd-repo-semtree] to cultivate and train a unified \"[semantic tree][reddit-musk]\" or \"knowledge bonsai\" across a collection of markdown files.\n3. A clean, lean, [yaml][yaml]-like [markup language for structured attributes][wibomd-repo-caml-mkdn] (with built-in `[[wikiref]]` support).\n4. [Graph][wibomd-repo-treehouze] utilities to experience and interact with a unified visual-spatial \"[memory palace][memory-palace]\" that emerges from the relationships formed across markdown notes (syntaxes 1 + 2).\n\nThese workflows are what distinguish \"WikiBonsai\" from other styles of digital garden -- particularly the [semantic tree][reddit-musk].\n\n## Project Info\n\n### Docs\n\nThe documentation in this repository describe the philosophies, mechanics, and terminologies that are adopted throughout all of the WikiBonsai projects:\n\n- For Use:\n  - [Getting Started][wibomd-doc-use]\n  - [Privacy and Security][wibomd-doc-secure]\n- For Dev:\n  - [Design Principles][wibomd-doc-design]\n  - [Terminology][wibomd-doc-terms]\n  - [Code of Conduct][wibomd-doc-code-of-conduct]\n  - [Contributing][wibomd-doc-contributing]\n- For Lore:\n  - [Guiding Philosophy][wibomd-doc-philosophy]\n  - [Origin Story][wibomd-doc-story]\n  - [Citations and Sources][wibomd-doc-cite]\n- For Input:\n  - [Questions][wibomd-doc-questions]\n\n### Repos\n\nThe 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:\n\n- For Use:\n  - AI:\n    - [germinator][wibomd-repo-germinator]: An AI-powered semantic seedling [germinator][demo-germinator] that generates starter semantic mappings of concepts which are easily transplantable into one's own digital garden.\n      - [semtree-germ][wibomd-repo-semtree-germ]: An earlier version of the germinator that focused on [semantic trees][demo-semtree-germ].\n    - [tree-trainer][wibomd-repo-tree-trainer]: An AI-powered [tree trainer][demo-tree-trainer] that generates syntax trees for sentence(s).\n    - [prompt][wibomd-repo-promp]: Prompts for AI-powered digital gardening.\n  - Notes:\n    - [vscode-tendr][wibomd-repo-vscode-tendr]: A [VSCode][git-vscode] extension for tending a WikiBonsai digital garden.\n    - [tendr-cli][wibomd-repo-tendr-cli]: A CLI tool for tending a markdown-based WikiBonsai digital garden.\n  - SSG:\n    - [jekyll-garden][wibomd-repo-jekyll-garden]: A [jekyll][ssg-jekyll] template that can be imported as a gem or cloned as a template project.\n    - [jekyll-bloomz][wibomd-repo-jekyll-bloomz]: An example setup to enable WikiBonsai workflows fro a [jekyll][ssg-jekyll]-bsaed statically generated site (SSG).\n    - [astro-bloomz][wibomd-repo-astro-bloomz]: An example setup to enable WikiBonsai workflows for an [astro][ssg-astro]-based statically generated site (SSG).\n    - [eleventy-bloomz][wibomd-repo-eleventy-bloomz]: An example setup to enable WikiBonsai workflows for [eleventy][ssg-eleventy]-based static site generation (SSG).\n  - Starters:\n    - [garden-beds][wibomd-repo-garden-beds]: A collection of starter WikiBonsai digital gardens -- includes starter markdown files and config files.\n- For Dev\n  - Markdown Parsers:\n    - [markdown-it-caml][wibomd-repo-markdown-it-caml]: A [markdown-it][git-markdown-it] plugin to enable  `:colon::attributes`.\n    - [markdown-it-wikirefs][wibomd-repo-markdown-it-wikirefs]: A [markdown-it][git-markdown-it] plugin to enable `[[wikirefs]]`.\n    - [remark-caml][wibomd-repo-remark-caml]: A [remark][git-remark] plugin to enable `:colon::attributes`.\n    - [remark-wikirefs][wibomd-repo-remark-wikirefs]: A [remark][git-remark] plugin to enable `[[wikirefs]]`.\n  - Jekyll:\n    - [jekyll-graph][wibomd-repo-jekyll-graph]: A jekyll plugin to generate graphs of blog content.\n    - [jekyll-semtree][wibomd-repo-jekyll-semtree]: A jekyll plugin to generate a semantic tree from index collections.\n    - [jekyl-wikirefs][wibomd-repo-jekyll-wikirefs]: A jekyll plugin to enable `[[wikirefs]]`.\n  - Base:\n    - [caml][wibomd-repo-caml-mkdn]: Base utilities for Colon Attribute Markup Language (`:colon::attributes`).\n    - [caudex][wibomd-repo-caudex]: An index to cache and store WikiBonsai relationships.\n    - [semtree][wibomd-repo-semtree]: Base utilities for \"semantic tree\" or \"knowledge bonsai\" building in markdown.\n    - [treehouze][wibomd-repo-treehouze]: Generalized graph utilities with minor specialized features for visualizing WikiBonsai-enabled markdown-based PKMs.\n    - [wikirefs][wibomd-repo-wikirefs]: Base utilities for internal links (`[[wikirefs]]`).\n  - Spec:\n    - [caml-spec][wibomd-repo-caml-spec]: Test suite for Colon Attribute Markup Language, CAML, (`:colon::attributes`) specification.\n    - [wikirefs-spec][wibomd-repo-wikirefs-spec]: Test suite for wikirefs (`[[wikirefs]]`) specification.\n\n## ⚠️ Usage Note\n\nThe systems you interact with have an effect on the way you think. This system is meant to provide a [\"jungle gym for the thought,\"][wibomd-doc-philosophy--a-jungle-gym-for-thought] but it can't do everything and might even have negative consequences if used improperly. Here are some supplemental suggestions for adopting a PKM-framework such as this, especially for educational purposes:\n\n### Write Full Essays\n\nThe workflows this project enables are meant to help develop an explicit relationship with the words you use. It's possible over-reliance on a tool like this (like many other digital productivity tools) can allow, or even facilitate, overly modular and fractured trains of thought. Writing [full essays][utb-essay] can combat fractured thinking and exercise those parts of the mind.\n\n### Refer to Common Cultural Reference Points\n###### (such as [britannica][britannica] or [wikipedia][wikipedia])\n\nBy adopting a tool specifically meant for mapping vocabulary, it can be tempting to use niche words or make up one's own to demarcate an idea. But too much of this risks building a Tower of Babel and losing the ability to communicate effectively with others. Use shared vocabulary where you can and if you've found a word of better fit, use it with others. That is the purpose of language after all.\n\n### There is Never a \"Final Word\"\n\nLike this project it is best to view a set of notes and explicit knowledge as a current state of affairs -- it's the state of the trail; of how much clutter has been cleared away. The goal is to build a navigable path for yourself, but to remain aware of what other things lie beyond the already-explored path. Always be open to what hard reality is telling you, especially while getting your hands dirty.\n\n### Get Your Hands Dirty\n\nThe digital world cannot replace practical, hands-in-the-mud experience. No matter what you learn or study be sure to learn something, _anything_, that requires your hands in the real world.\n\n## Forward\n\nHere's to making the road ahead a touch less bumpy and a bit more wonder-full for those that follow.\n\n[**just keep tending...🪴**][wibomd-doc-use]\n\n\n[^ai]: 🤖 AI Collaboration: To date, code and prose of the WikiBonsai project was not written by AI, but was _occasionally_ consulted to improve overall quality. This may or may not change going forward.\n[^mind]: Not too dissimilar from a [\"bicycle for the mind\"][utb-mind-bike].\n[^mixed-metaphors]: Please excuse the mixed metaphor soup.\n\n[art-unix-phil]: \u003chttps://ia902701.us.archive.org/12/items/bstj57-6-1899/bstj57-6-1899_text.pdf\u003e\n[britannica]: \u003chttps://britannica.com/\u003e\n[demo-germinator]: \u003chttps://germ-inator.netlify.app\u003e\n[demo-semtree-germ]: \u003chttps://semantic-tree.netlify.app\u003e\n[demo-tree-trainer]: \u003chttps://tree-trainer.netlify.app\u003e\n[reddit-musk]: \u003chttps://www.reddit.com/r/IAmA/comments/2rgsan/comment/cnfput4/\u003e\n[git-markdown-it]: \u003chttps://github.com/markdown-it/markdown-it\u003e\n[git-remark]: \u003chttps://github.com/remarkjs/remark\u003e\n[git-vscode]: \u003chttps://github.com/microsoft/vscode\u003e\n[mediawiki-internal-link]: \u003chttps://www.mediawiki.org/wiki/Help:Links#Internal_links\u003e\n[memory-palace]: \u003chttps://artofmemory.com/blog/how-to-build-a-memory-palace/\u003e\n[ssg-astro]: \u003chttps://github.com/withastro/astro\u003e\n[ssg-jekyll]: \u003chttps://github.com/jekyll/jekyll\u003e\n[ssg-eleventy]: \u003chttps://github.com/11ty/eleventy/\u003e\n[utb-essay]: \u003chttps://www.youtube.com/watch?v=XHIhtWPpDVI\u003e\n[utb-mind-bike]: \u003chttps://www.youtube.com/watch?v=KmuP8gsgWb8\u003e\n[wikipedia]: \u003chttps://www.wikipedia.org\u003e\n[yaml]: \u003chttps://yaml.org/\u003e\n\n[wibomd-doc-cite]: \u003chttps://github.com/wikibonsai/wikibonsai/tree/main/docs/CITE.md\u003e\n[wibomd-doc-cite-this]: \u003chttps://github.com/wikibonsai/wikibonsai/tree/main/CITATION.bib\u003e\n[wibomd-doc-code-of-conduct]: \u003chttps://github.com/wikibonsai/wikibonsai/tree/main/docs/CODE_OF_CONDUCT.md\u003e\n[wibomd-doc-contributing]: \u003chttps://github.com/wikibonsai/wikibonsai/tree/main/CONTRIBUTING.md\u003e\n[wibomd-doc-design]: \u003chttps://github.com/wikibonsai/wikibonsai/tree/main/docs/DESIGN.md\u003e\n[wibomd-doc-design--an-api-for-the-mind]: \u003chttps://github.com/wikibonsai/wikibonsai/tree/main/docs/DESIGN.md#an-api-for-the-mind\u003e\n[wibomd-doc-design--drilling-down-to-standardization-bedrock]: \u003chttps://github.com/wikibonsai/wikibonsai/tree/main/docs/DESIGN.md#drilling-down-to-standardization-bedrock\u003e\n[wibomd-doc-design--semantic-space]: \u003chttps://github.com/wikibonsai/wikibonsai/tree/main/docs/DESIGN.md#semantic-space8\u003e\n[wibomd-doc-philosophy]: \u003chttps://github.com/wikibonsai/wikibonsai/tree/main/docs/PHILOSOPHY.md\u003e\n[wibomd-doc-philosophy--a-jungle-gym-for-thought]: \u003chttps://github.com/wikibonsai/wikibonsai/tree/main/docs/PHILOSOPHY.md#a-jungle-gym-for-thought\u003e\n[wibomd-doc-philosophy--finding-free-will]: \u003chttps://github.com/wikibonsai/wikibonsai/tree/main/docs/PHILOSOPHY.md#finding-free-will\u003e\n[wibomd-doc-questions]: \u003chttps://github.com/wikibonsai/wikibonsai/tree/main/docs/Q.md\u003e\n[wibomd-doc-secure]: \u003chttps://github.com/wikibonsai/wikibonsai/tree/main/docs/SECURE.md\u003e\n[wibomd-doc-story]: \u003chttps://github.com/wikibonsai/wikibonsai/tree/main/docs/STORY.md\u003e\n[wibomd-doc-terms]: \u003chttps://github.com/wikibonsai/wikibonsai/tree/main/docs/TERMS.md\u003e\n[wibomd-doc-use]: \u003chttps://github.com/wikibonsai/wikibonsai/tree/main/docs/USE.md\u003e\n\n[wibomd-repo-astro-bloomz]: \u003chttps://github.com/wikibonsai/astro-bloomz\u003e\n[wibomd-repo-caml-mkdn]: \u003chttps://github.com/wikibonsai/caml-mkdn\u003e\n[wibomd-repo-caml-spec]: \u003chttps://github.com/wikibonsai/caml-mkdn/tree/main/spec\u003e\n[wibomd-repo-caudex]: \u003chttps://github.com/wikibonsai/caudex\u003e\n[wibomd-repo-eleventy-bloomz]: \u003chttps://github.com/wikibonsai/eleventy-bloomz\u003e\n[wibomd-repo-garden-beds]: \u003chttps://github.com/wikibonsai/garden-beds\u003e\n[wibomd-repo-germinator]: \u003chttps://github.com/wikibonsai/germinator\u003e\n[wibomd-repo-jekyll-bloomz]: \u003chttps://github.com/wikibonsai/jekyll-bloomz\u003e\n[wibomd-repo-jekyll-graph]: \u003chttps://github.com/wikibonsai/jekyll-graph\u003e\n[wibomd-repo-jekyll-semtree]: \u003chttps://github.com/wikibonsai/jekyll-semtree\u003e\n[wibomd-repo-jekyll-garden]: \u003chttps://github.com/wikibonsai/jekyll-garden\u003e\n[wibomd-repo-jekyll-wikirefs]: \u003chttps://github.com/wikibonsai/jekyll-wikirefs\u003e\n[wibomd-repo-markdown-it-caml]: \u003chttps://github.com/wikibonsai/markdown-it-caml\u003e\n[wibomd-repo-markdown-it-wikirefs]: \u003chttps://github.com/wikibonsai/markdown-it-wikirefs\u003e\n[wibomd-repo-promp]: \u003chttps://github.com/wikibonsai/prompt\u003e\n[wibomd-repo-remark-caml]: \u003chttps://github.com/wikibonsai/remark-caml\u003e\n[wibomd-repo-remark-wikirefs]: \u003chttps://github.com/wikibonsai/remark-wikirefs\u003e\n[wibomd-repo-semtree]: \u003chttps://github.com/wikibonsai/semtree\u003e\n[wibomd-repo-semtree-germ]: \u003chttps://github.com/wikibonsai/semtree-germ\u003e\n[wibomd-repo-tree-trainer]: \u003chttps://github.com/wikibonsai/tree-trainer\u003e\n[wibomd-repo-tendr-cli]: \u003chttps://github.com/wikibonsai/tendr-cli\u003e\n[wibomd-repo-treehouze]: \u003chttps://github.com/wikibonsai/treehouze\u003e\n[wibomd-repo-vscode-tendr]: \u003chttps://github.com/wikibonsai/vscode-tendr\u003e\n[wibomd-repo-wikirefs]: \u003chttps://github.com/wikibonsai/wikirefs\u003e\n[wibomd-repo-wikirefs-spec]: \u003chttps://github.com/wikibonsai/wikirefs/tree/main/spec\u003e\n\n\n\u003cp align=\"center\"\u003e\n  \u003cspan\u003e🇺🇸 Made in the USA 🦅 🐊\u003c/span\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwikibonsai%2Fwikibonsai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwikibonsai%2Fwikibonsai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwikibonsai%2Fwikibonsai/lists"}