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 research papers
reasonsforge paper --arxiv 2301.12345 --output reasons.db


# Run in a sandbox
reasonsforge run --sandbox=container code --repo ./untrusted-code

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”