Grant Finder

grant-finder

A deterministic Go CLI that turns a Research Assignment JSON into an evidence-backed candidate list of non-dilutive funding opportunities. The CLI does not call an LLM; it operates on a local SQLite ledger refreshed from Grants.gov, the Federal Register, public agency RSS feeds, and configured public source pages. Final ranking and recommendation judgment belong to the calling agent.

When to use

• An upstream task gave you a lab, startup, nonprofit, or technical-project brief, or a Research Assignment JSON, and you need to surface matching funding opportunities.
• You need source-cited evidence for one candidate (explain).
• You need to check ledger freshness or source-lane coverage (status).

Public commands

# Return candidate opportunities for a Research Assignment
grant-finder research --assignment <path|-> --json

# Show evidence and provenance for one candidate
grant-finder explain <recommendation-id|opportunity-id> --json

# Report ledger freshness and source-lane coverage
grant-finder status --assignment <path> --json

# Self-check: SQLite/FTS5/usearch availability + manifest counts
grant-finder doctor --json

Common flags

--db <path>            SQLite ledger path (default ~/.local/share/grant-finder/grant-finder.sqlite)
--json                 JSON output (default for agent flows)
--compact              Compact JSON
--select <fields>      Project top-level paths (comma-separated, dot-pathed)
--limit N              Result count (default 10 for research)
--refresh auto|off     Refresh stale source lanes before answering. Default: auto
--semantic auto|usearch|off   Default: auto (usearch when available, FTS5 fallback)
--include-inactive     Include closed/archived/past-due records (off by default)

Notes

• Pipe the assignment JSON via stdin with --assignment - rather than writing to a temp file when possible.
• Always verify retrieval.no_llm == true (or no_llm: true on explain) in the response — drift guard against future regressions.
• The CLI is deterministic; the same assignment against the same ledger produces the same packet.

Where to read more

• Top-level README: https://github.com/openprose/grant-finder/blob/main/README.md
• Contributor docs: https://github.com/openprose/grant-finder/blob/main/AGENTS.md
• Schemas: schemas/research-assignment.schema.json, schemas/research-packet.schema.json in the repo.

Install

# Binary, from the grant-finder repository root
(cd cli/grant-finder && go build -o "$HOME/.local/bin/grant-finder" ./cmd/grant-finder)

# Skill (this file). Refresh old symlinks; do not overwrite custom directories.
skills_dir="$HOME/.codex/skills"  # or ~/.claude/skills, ~/.agents/skills
mkdir -p "$skills_dir"
target="$skills_dir/grant-finder"
if [ -e "$target" ] && [ ! -L "$target" ]; then
  echo "Existing non-symlink skill path: $target"
  exit 1
fi
ln -sfn "$PWD/skills/grant-finder" "$target"