CLI Reference
Global options
Section titled “Global options”reasonsforge [OPTIONS] COMMAND [ARGS]| Option | Description |
|---|---|
--version |
Show version and exit |
--help |
Show help and exit |
--output, -o |
Output path for reasons.db (default: ./reasons.db) |
Forge commands
Section titled “Forge commands”reasonsforge code
Section titled “reasonsforge code”Build a knowledge base from a codebase.
reasonsforge code --repo ./my-project --output reasons.db| Option | Description |
|---|---|
--repo |
Path to the git repository |
--output, -o |
Output path (default: reasons.db) |
reasonsforge product
Section titled “reasonsforge product”Build a knowledge base from GitHub/GitLab/Jira issues.
reasonsforge product --github owner/repo --output reasons.db| Option | Description |
|---|---|
--github |
GitHub repository (owner/repo format) |
--gitlab |
GitLab project path |
--jira |
Jira project key |
--domain |
Domain description for product context |
--output, -o |
Output path (default: reasons.db) |
reasonsforge project
Section titled “reasonsforge project”Build a knowledge base from project management data.
reasonsforge project --github owner/repo --output reasons.db| Option | Description |
|---|---|
--github |
GitHub repository (owner/repo format) |
--output, -o |
Output path (default: reasons.db) |
reasonsforge paper
Section titled “reasonsforge paper”Build a knowledge base from academic papers.
reasonsforge paper --arxiv 2301.12345 --output reasons.db| Option | Description |
|---|---|
--arxiv |
arXiv paper ID |
--doi |
DOI identifier |
--pdf |
Path to a local PDF |
--output, -o |
Output path (default: reasons.db) |
reasonsforge document
Section titled “reasonsforge document”Build a knowledge base from arbitrary documents.
reasonsforge document --input ./docs/ --output reasons.db| Option | Description |
|---|---|
--input |
Path to documents directory |
--output, -o |
Output path (default: reasons.db) |
Sandbox commands
Section titled “Sandbox commands”reasonsforge run
Section titled “reasonsforge run”Run a forge command inside a sandbox.
reasonsforge run --sandbox=container code --repo ./project| Option | Description |
|---|---|
--sandbox |
Sandbox tier: container, bubblewrap, firejail, vm |
All arguments after the sandbox flag are passed to the forge command.