# Foam

A personal knowledge management and sharing system for VSCode

Repository: https://github.com/foambubble/foam
Canonical: https://ross.abutalabs.com/products/foam
Homepage: https://foam.md
Language: TypeScript
License: NOASSERTION
License Family: other
Topics: graph-visualisation, markdown, markdown-editor, pkm, zettelkasten, note-taking, vscode, notes-app, personal-knowledge-base
Last push: 2026-08-13T10:45:00+00:00
Link (homepage): https://foam.md

## Health v2 (maintenance only)
Score: 93/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 97, release rhythm 84, longevity 100
- inputs: {"age_days": 2266, "days_push": 20, "days_rel": 111, "gap_med": 0.0, "n_releases_24m": 37}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 17379, forks 774 (observed 2026-08-28T04:11:19.601354+00:00)

## What it is
Foam is a personal knowledge management (PKM) and sharing system built on VS Code and GitHub, inspired by Zettelkasten-style note-taking. It provides wikilink autocompletion, graph visualization, backlink navigation, and optional publishing of your notes to the web.

## Use cases
- organize research notes with markdown and wikilinks
- visualize a personal knowledge graph
- take Zettelkasten-style notes in VS Code
- keep backlinks and references between notes up to date
- publish a personal knowledge base as a website
- manage a personal wiki inside the editor

## When to choose
- you already use VS Code and want note-taking without leaving the editor
- you want plain markdown files you fully own and can version with git
- you need graph views, backlinks, and wikilink autocompletion for a personal knowledge base
- you want a free, extensible alternative to Roam or Obsidian

## When to avoid
- you want a polished standalone note app with a native mobile experience
- you don't use VS Code and don't want to learn it
- you need built-in real-time collaboration or hosted sync out of the box
- you prefer opinionated, batteries-included PKM apps over assembling your own workflow

## Facets
- artifact type: plugin
- maturity: active
- function: editor, markdown, documentation, data-visualization
- domain: developer-tools, text-editors
- platform: editor-plugin, cross-platform
- tags: pkm, zettelkasten, note-taking, vscode-extension, knowledge-graph, wikilinks, knowledge-management, desktop

## Member repositories
- foambubble/foam (main) score 93
- foambubble/foam-template (examples) score 74

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:19.601354+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:02:58.838741+00:00, confidence not recorded.
  - readme: https://github.com/foambubble/foam (fetched 2026-08-28T04:11:19.601354+00:00, sha 4c4419f96f39)
  - homepage: https://foam.md (fetched 2026-08-29T08:01:33.425518+00:00, sha 322f0f0ec8ef)
- Data as of 2026-08-30T08:39:29.467469+00:00.