Skip to content
Reasons Forge

Quickstart

Install

Section titled “Install”
Terminal window
pip install reasonsforge

Build a knowledge base

Section titled “Build a knowledge base”
Terminal window
# From a codebase
reasonsforge code --repo ./my-project --output reasons.db


# From GitHub issues
reasonsforge product --github owner/repo --output reasons.db


# From documents and PDFs (chunked by section)
reasonsforge document --pdf paper.pdf --output reasons.db


# Cross-domain synthesis across expert belief networks
reasonsforge meta init code=/path/to/code-expert project=/path/to/project-expert
reasonsforge meta update

Your first knowledge base in under 5 minutes. The output is a SQLite file — open it with Reasons.app, the reasons CLI, or any SQLite client.

Use the output

Section titled “Use the output”

The reasons.db file works with any of these:

  • Reasons.app — macOS menu bar MCP server (reasonsforge.com)
  • reasons CLI — reasons --db reasons.db search "query"
  • Claude Code — via MCP or CLI skill
  • Claude Desktop — via MCP or drag-and-drop skill
  • Any MCP client — standard Streamable HTTP or stdio transport
  • Raw SQLite — it is just a database file

Next steps

Section titled “Next steps”