# Night Porter docs

> Night Porter handles your PRs while you’re away: a daemon and terminal UI that watch GitHub, GitLab and Forgejo/Gitea for review comments, failing CI and merge conflicts on your PRs and MRs, then run Claude Code, OpenCode, Codex or Gemini CLI (experimental) on your local clone, within the rules you set. It never merges, force-pushes, closes or approves.

Every page as one file: https://docs.night-porter.com/llms-full.txt. Website: https://night-porter.com. Source: https://github.com/night-porter/nightporter.

## Guide

- [What's new in 0.4](https://docs.night-porter.com/whats-new): What's new in Night Porter 0.4: reviews prepared when someone requests yours, backlog sweeps, a Worktrees tab with undo for maintainers, handoffs to pi, Cursor, Copilot and more, per-agent models; and in 0.3: notifications on your phone, day and night shifts, PR-comment commands, Forgejo/Gitea, Gemini CLI (experimental) and more handoff targets.
- [Getting started](https://docs.night-porter.com/getting-started): Install Night Porter with Homebrew, the install script or Cargo, run the setup wizard, subscribe to a repo and pick an autonomy level.
- [Daily use](https://docs.night-porter.com/daily-use): Using Night Porter day to day: the TUI tabs, approving, rejecting and dismissing jobs, the inbox for untrusted authors, settings, the CLI, and turning it off.
- [herdr, Rex, tmux, Zellij](https://docs.night-porter.com/herdr): Take over a Night Porter job interactively in herdr, Rex, tmux, Zellij or a new terminal, open the queue as a herdr popup, and script Night Porter with events and wait.
- [Troubleshooting](https://docs.night-porter.com/troubleshooting): Fix Night Porter problems: start with nightporter doctor, then what to check when a job does not start, fails or keeps waiting.

## Configuration

- [Reference](https://docs.night-porter.com/configuration): Every Night Porter setting: config.toml, per-repo override files, defaults, trust rules, schedules, checks and the limits config cannot change.
- [Advanced recipes](https://docs.night-porter.com/advanced): Night Porter recipes: levels per repo, working hours, trust rules, limits and budgets, sandboxing, DDEV and Docker environments, maintainer mode and replies.
- [Writing packs](https://docs.night-porter.com/writing-packs): Write a Night Porter pack: extra review steps, reply styles and environment presets as TOML and Markdown, and publish it in a marketplace.

## Project

- [Threat model](https://docs.night-porter.com/threat-model): How Night Porter stays safe when acting on text written by strangers: trust, credential isolation, sandboxing and pre-push checks.
- [Reporting issues](https://docs.night-porter.com/reporting-issues): How to report a Night Porter bug or a security vulnerability, and what to include.
- [Contributing](https://docs.night-porter.com/contributing): How to contribute to Night Porter: getting the code building, ground rules, packs, and editing these docs.