knowledge-forge

What problem does it solve?

Knowledge workers and developers often struggle to convert harvested session data and project analyses into a coherent, navigable knowledge base. Knowledge Forge automates structuring, tagging, and linking notes into Obsidian-compatible Markdown with consistent frontmatter and references.

Core Features & Use Cases

• Session-to-note synthesis: transforms daily sessions into well-structured session logs with frontmatter, tags, and cross-links.
• Project index creation: builds and updates per-project overview notes including recent sessions and tech stack.
• Cross-project developer log: aggregates activity across projects to a centralized developer diary.
• Interlinks and navigation: auto-generates bidirectional links to projects, sessions, architecture, and changelog for rich navigation.

Quick Start

Install Python 3.x (no external dependencies required) and run the synthesize script with your harvested data. Example: python3 scripts/synthesize.py --input path/to/harvest.json. To process all cached files, run with --all. To preview changes without writing, use --dry-run.