GitHub commits — `github`

Polls a repo’s commits (cursor by SHA), one event per commit, keyed by repo, with author and branch as labels. Supports discovery: given a repo, it validates access and finds the default branch.

Prerequisites: none for a public repo. For a private repo (or higher rate limits), a GitHub token — set the GITHUB_TOKEN environment variable on the daemon.

Set up

Agent

Ask a connected agent:

Use navflow to ingest commits from glassflow/navflow.

The agent calls discover_source (validates the repo, proposes the config and labels), test_source (dry-run — fetches sample commits without creating anything), then create_source. Ingestion starts immediately.

Console

Sources → Add source → github. Set:

repo: owner/name, e.g. glassflow/navflow

Discover validates the repo and fills the default branch; the repo (key), author, and branch labels are pre-filled. Save.

YAML / API


- name: commits
  connector: github
  poll: 30s
  config:
    repo: glassflow/navflow
    labels:
      - { name: repo, field: repo, primary: true }
      - { name: author, field: author }

Or POST /api/sources with the same object.

Configuration

field	type	description
`repo`*	string	`owner/name`, e.g. `glassflow/navflow`
`branch`	string	branch to follow (default: the repo’s default branch)
`token`	string	token for private repos / higher rate limits (prefer `GITHUB_TOKEN`)
`limit`	number	commits to fetch per poll (default 20)
`api_url`	string	GitHub API base for GitHub Enterprise (default `https://api.github.com`)

Prefer the GITHUB_TOKEN environment variable over the token field — a token in the config is exported to the catalog YAML.

Provided labels

repo (the key), author (commit author’s GitHub login), branch.

Verify

Open the source in the console: Recent events shows commits on the next poll; Explore lists the repo and authors as entities and reads their timelines.

GitHub commits — github