Night Watch CLI

Night Watch CLI is a local Node.js command-line tool built with a Turborepo-managed Monorepo architecture, written in TypeScript, and bundled using esbuild. Its core mechanism uses Git Worktree to create isolated environments for each task and relies on five built-in agents (Executor, Reviewer, QA, Slicer, Auditor) operating at different frequencies to form a complete closed loop—from requirement slicing and code implementation to automated scoring and e2e testing.

Asynchronous Execution & Isolation#

• Queue-based Task Scheduling: Enqueue PRD files or Board Issues for sequential background execution, delivering PRs by the next morning.
• Cron Automation: One-click cron job setup via night-watch install for fully unattended operation.
• Git Worktree Isolation: Each task runs in an independent git worktree, keeping the main branch clean.

Multi-Agent Collaboration System#

• Executor (hourly): Reads specs, implements code, and creates PRs.
• Reviewer (every 3 hours): Scores generated PRs from 0-100, sends low-scoring PRs back for fixes, and can auto-merge high-scoring ones.
• QA (4 times daily): Automatically generates and runs Playwright e2e tests.
• Slicer (every 6 hours): Intelligently splits large Epics into fine-grained executable subtasks.
• Auditor (weekly): Scans codebase quality globally (e.g., detecting unused dependencies).

LLM Provider Ecosystem#

• Claude CLI: Default provider with --dangerously-skip-permissions auto mode.
• Codex CLI: Supports --yolo auto mode.
• Compatible Endpoints: Supports GLM-5 and any Anthropic-compatible endpoint via providerEnv configuration.

Observability & Management#

• Board Management: Full lifecycle tracking from Draft → Ready → In Progress → Review → Done.
• Web Dashboard: Built-in Web UI (default localhost:3000) with SSE real-time push of Agent status and execution progress, no external hosting required.

Installation & Quick Start#

npm install -g @jonit-dev/night-watch-cli
cd your-project
night-watch init
night-watch doctor
night-watch run --dry-run
night-watch board create-prd "Implement feature X" --priority P1
night-watch run           # Single run
night-watch install       # Install cron scheduled tasks

Core Configuration (night-watch.config.json)#

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

Use Cases#

Primarily suited for bounded tasks with clear boundaries that can execute independently (e.g., bug fixes, dependency upgrades, QA regressions, documentation updates). The entire workflow adheres to the Human-in-the-loop principle, allows configurable auto-merge thresholds, and is open-sourced under the MIT license.

Not suited for: Exploratory work requiring frequent iterative clarification; teams whose standards don't accept AI-generated PRs; scenarios needing real-time pair-programming interaction.

Unconfirmed Information#

• Website states "v1.0 is now live" but GitHub Releases has no formal tag/release; actual version should be verified via npm.
• npm download counts and publish details unavailable due to Cloudflare challenge page.
• GitHub organization is jonit-dev; no team member details disclosed in README.