Night Watch CLI

Autonomous PRD execution using AI Provider CLIs + cron

Night Watch is a battle-tested autonomous PRD executor that uses AI provider CLIs (Claude CLI or Codex) + cron to implement PRD tickets, open PRs, and fix CI failures — all while you sleep.

Table of Contents

• Quick Start
• Supported Providers
• Using GLM-5 or Custom Endpoints
• Installation
• Documentation
• License

Quick Start

# 1. Install globally
npm install -g night-watch-cli

# 2. Initialize in your project
cd your-project
night-watch init

# 3. Check provider detection
night-watch run --dry-run

# 4. Add your PRD files
echo "# My First PRD\n\nImplement feature X..." > docs/PRDs/night-watch/my-feature.md

# 5. Run or install cron
night-watch run           # Run once
night-watch install       # Setup automated cron

Supported Providers

| Provider | CLI Command | Auto-Mode Flag | Slash Commands | |----------|-------------|----------------|----------------| | claude | claude | --dangerously-skip-permissions | -p "/command-name" | | codex | codex | --yolo | --prompt "text" |

• Default provider is claude
• Change with --provider codex flag or "provider": "codex" in config

Using GLM-5 or Custom Endpoints

Night Watch supports passing custom environment variables to the provider CLI via the providerEnv config field. This lets you point the Claude CLI at any Anthropic-compatible endpoint — including GLM-5.

Add providerEnv to your night-watch.config.json:

{
  "provider": "claude",
  "providerEnv": {
    "ANTHROPIC_API_KEY": "your-glm5-api-key",
    "ANTHROPIC_BASE_URL": "https://your-glm5-endpoint.example.com"
  }
}

These variables are:

• Injected into the provider CLI process at runtime (night-watch run, night-watch review)
• Exported in cron entries when you run night-watch install, so automated runs also pick them up
• Visible in --dry-run output for easy debugging

Common Use Cases

| Use Case | Environment Variables | |----------|----------------------| | GLM-5 via custom endpoint | ANTHROPIC_API_KEY, ANTHROPIC_BASE_URL | | Proxy / VPN routing | HTTPS_PROXY, HTTP_PROXY | | Custom model selection | Any provider-specific env var |

See Configuration > Provider Environment for full details.

Installation

npm (Recommended)

npm install -g night-watch-cli

npx (No install)

npx night-watch-cli init

From Source

git clone https://github.com/jonit-dev/night-watch-cli.git
cd night-watch-cli
npm install && npm run build && npm link

Documentation

| Document | Description | |----------|-------------| | Commands Reference | All CLI commands and their options | | Configuration | Config file, environment variables, CLI flags, providerEnv, notifications | | PRD Format | How to write PRDs, dependencies, lifecycle | | Architecture | System design, execution flows, project structure | | Troubleshooting | Common errors and how to fix them | | Local Testing | Test the CLI locally without publishing | | Contributing | Development setup, building, testing, publishing |

License

MIT License - see LICENSE for details.