llms.txt
Compare with other sites' llms.txt files →# Nom
> Nom is a GitHub activity feed platform. It aggregates pull requests, issues, releases, and pushes from public GitHub repositories into a unified, AI-summarised feed.
## AI Agents: Feed URLs → Use the API
The web feed UI at https://nomit.dev (including URLs with `?q=`) is client-rendered. If you fetch the HTML you may see only a loading state. **Use the feed API instead** — no auth required.
| Feed URL you encountered | Use this API instead |
|--------------------------|----------------------|
| https://nomit.dev/?q=org:vercel repo:next.js | GET https://nomit.dev/api/feed?q=org:vercel%20repo:next.js |
| https://nomit.dev/vercel/next.js | GET https://nomit.dev/api/feed/vercel/next.js |
| https://nomit.dev/vercel/next.js?q=typescript | GET https://nomit.dev/api/feed/vercel/next.js?q=typescript |
Rule: If the path is `/{org}/{repo}`, use `GET /api/feed/{org}/{repo}` with the same `q` param. Otherwise use `GET /api/feed?q=...` with the same `q` param.
## What Nom Does
- Tracks activity across GitHub repositories (PRs, issues, releases, pushes)
- Generates AI summaries for each event
- Provides a public read API for programmatic access
## Public API
Base URL: https://nomit.dev
### GET /api/feed
Fetch the global public activity feed.
Query parameters:
- `q` — Search string. Supports filter prefixes:
- `org:vercel` — filter by GitHub org
- `repo:next.js` — filter by repo name
- `type:pull_request` — filter by event type (`pull_request`, `issue`, `release`, `push`)
- `from:2026-01-01` — filter events updated on or after this date (ISO 8601)
- `to:2026-02-01` — filter events updated on or before this date (ISO 8601)
- Free text (after removing prefixes) is full-text searched
- `limit` — Number of results to return (default: 20, max: 100)
- `offset` — Pagination offset (default: 0)
Example requests:
- `GET /api/feed` — latest activity across all public repos
- `GET /api/feed?q=org:vercel&limit=10` — latest 10 events from the Vercel org
- `GET /api/feed?q=type:pull_request from:2026-01-01` — PRs since Jan 2026
- `GET /api/feed?q=typescript&limit=5` — full-text search for "typescript"
### GET /api/feed/{org}/{repo}
Fetch the activity feed for a specific repository.
Path parameters:
- `org` — GitHub organisation or user (e.g. `vercel`)
- `repo` — Repository name (e.g. `next.js`)
Query parameters:
- `q` — Free-text search string (no filter prefixes needed)
- `limit` — default 20, max 100
- `offset` — default 0
Example requests:
- `GET /api/feed/vercel/next.js` — latest activity for vercel/next.js
- `GET /api/feed/vercel/next.js?q=typescript&limit=5` — searched activity
### GET /api/feed/rss
RSS 2.0 feed for the global public activity feed. No search filters; pagination only.
Query parameters:
- `limit` — default 20, max 100
- `offset` — default 0
Example requests:
- `GET /api/feed/rss` — latest activity across all public repos
- `GET /api/feed/rss?limit=20` — latest 20 items
Returns: `application/rss+xml`
### GET /api/feed/{org}/{repo}/rss
RSS 2.0 feed for a specific repository. No search filters; pagination only.
Path parameters:
- `org` — GitHub organisation or user
- `repo` — Repository name
Query parameters:
- `limit` — default 20, max 100
- `offset` — default 0
Example requests:
- `GET /api/feed/vercel/next.js/rss` — latest activity for vercel/next.js
- `GET /api/feed/vercel/next.js/rss?limit=10` — latest 10 items
Returns: `application/rss+xml`
### Response Shape
Both endpoints return the same JSON structure:
```json
{
"items": [
{
"id": "uuid",
"type": "pull_request",
"org": "vercel",
"repo": "next.js",
"title": "Add turbo support",
"summary": "AI-generated one-paragraph summary of this event",
"url": "https://github.com/vercel/next.js/pull/123",
"author": "timneutkens",
"contributors": ["timneutkens", "shuding"],
"updated_at": "2026-02-18T12:00:00Z"
}
],
"pagination": {
"offset": 0,
"limit": 20,
"has_more": true
}
}
```
Event types: `pull_request`, `issue`, `release`, `push`
## CLI / curl
The feed API is public; no authentication required.
**Global feed**
```bash
curl -sS "https://nomit.dev/api/feed?limit=10"
```
**Global feed with filters**
```bash
curl -sS "https://nomit.dev/api/feed?q=org:vercel&limit=10"
curl -sS "https://nomit.dev/api/feed?q=type:pull_request%20from:2026-01-01&limit=20"
```
**RSS feed**
```bash
curl -sS "https://nomit.dev/api/feed/rss?limit=20"
curl -sS "https://nomit.dev/api/feed/vercel/next.js/rss?limit=10"
```
## Agent Skill
An installable agent skill (SKILL.md format) is available at https://nomit.dev/skill.md.
**Name**: `nom`
**When to use**: When asked to check recent PRs, issues, releases, or pushes from a GitHub org or repo, or to search the global feed. Supports filtering by org, repo, event type, date range, and free text. Can return JSON or RSS.
**What the skill covers**:
- Endpoints: global feed, repo feed, global RSS, repo RSS
- Query params: `limit`, `offset`, `q` with filter syntax (`org:`, `repo:`, `type:`, `from:`, `to:`)
- Response shape and how to present items (type label, title link, summary, author, timestamp)
- Input validation for `org`/`repo` and URL encoding
**Install**: Fetch https://nomit.dev/skill.md and load into your skill system.
## Key Pages
- https://nomit.dev — Home / global public feed
- https://nomit.dev/{org}/{repo} — Repository-specific feed (e.g. https://nomit.dev/vercel/next.js)
- https://nomit.dev/api/feed — Global feed API
- https://nomit.dev/api/feed/{org}/{repo} — Repo feed API
- https://nomit.dev/api/feed/rss — Global feed RSS
- https://nomit.dev/api/feed/{org}/{repo}/rss — Repo feed RSS