# 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