Knowledge Sources (GitHub)

Index external repositories (starting with GitHub) and search them with hybrid retrieval (semantic + keyword). Built for long-lived engineering context.

Plan Requirement

Knowledge Sources are available on Pro and Enterprise. See pricing.

Connect GitHub

Go to Dashboard → Knowledge and click Connect. This authorizes veriova to list repos and fetch content for indexing. Tokens are stored encrypted at rest.

Add a Repo as a Source + Sync

After connecting GitHub, pick a repository and click Add. That creates a Knowledge Source and queues an initial sync. You can trigger re-syncs any time.

Create Knowledge Source (API)

POST https://api.veriova.com/api/v1/knowledge-sources?project=<project_slug>
Authorization: Bearer cv_...
Content-Type: application/json

{
  "provider": "github",
  "name": "owner/repo",
  "config": { "repo": "owner/repo", "ref": "main" }
}

Search Knowledge

Search returns ranked chunks with file paths and a score. If embeddings exist, semantic search is used; otherwise it falls back to keyword search.

Search Knowledge (API)

POST https://api.veriova.com/api/v1/knowledge/search?project=<project_slug>
Authorization: Bearer cv_...
Content-Type: application/json

{ "query": "where is the deploy workflow defined?", "k": 10 }

What Gets Indexed

The MVP indexer focuses on text-like files (docs + code) and skips large/binary content. It also enforces conservative caps (files/bytes) to keep costs predictable.