Skip to content

Getting Started

Prerequisites

  • Python 3.12+
  • Git 2.20+
  • Claude Code CLI installed and authenticated
  • Codex CLI installed and authenticated (optional)

Installation

pip install hpnc

For development:

git clone https://github.com/julian-w/hpnc.git
cd hpnc
uv sync

Initialize your project

cd your-project
hpnc init

This creates _hpnc/ with:

  • config.yaml — project configuration
  • executor-instructions.md — rules for AI agents
  • night-queue.yaml — empty task queue

Prepare a story

Create a story file with night-ready frontmatter:

---
night_ready: true
executor: opus
reviewer: codex
risk: low
tests_required: true
blocking_questions: []
gates_required:
  - build
  - tests
  - lint
---

# My Task

As a developer, I want...

Add to queue and validate

hpnc queue add stories/my-task.md
hpnc validate

Run

# Test with mock agents first
hpnc start --mock

# Real night run
hpnc start

# Schedule for tonight
hpnc start --at 23:00

Check results

hpnc status