# Nix Github Rate Limit

> Prevents and handles GitHub API rate limits with gh-nix. Use when Nix, flakes, nixpkgs commands, or comma may fetch GitHub-backed inputs.

- Skill: `ryoppippi/nix-github-rate-limit` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ryoppippi/nix-github-rate-limit`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ryoppippi/nix-github-rate-limit/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: ryoppippi (https://skillmd.com/u/ryoppippi)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ryoppippi/nix-github-rate-limit

---


Use this skill before Nix commands that may fetch from GitHub.

## Preferred path

Prefix the command with `gh-nix`; it reads the token from authenticated `gh` without putting it in the command:

```sh
gh-nix nix flake update
gh-nix nix run github:<owner>/<repo>
gh-nix nix run nixpkgs#<package> -- <args>
gh-nix nix build
gh-nix nix shell nixpkgs#<package> --command <command>
gh-nix , <command>
```

For this repo: `gh-nix nix run .#build`, `gh-nix nix run .#switch`, or `gh-nix nix run .#update`.

Check availability with `command -v gh-nix`. If it is unavailable, use an existing safe token source:

```sh
NIX_CONFIG="access-tokens = github.com=$(gh auth token)" nix <command>
NIX_CONFIG="access-tokens = github.com=$GITHUB_TOKEN" nix <command>
NIX_CONFIG="access-tokens = github.com=$(ghtkn get)" nix <command>
```

Never paste, print, persist, or commit tokens. If `gh-nix` reports that `gh` is unauthenticated, ask the user to run `gh auth login`. Retry a rate-limit failure once with `gh-nix` or the safest available fallback.

