NightShift Documentation

Everything you need to solve problems autonomously — and watch the system get smarter with every run.

🚀
Getting Started

Install NightShift, run your first problem, and understand the YAML format. Up and running in 5 minutes.

Read guide →
🏛
Architecture

Deep-dive into the 9 pillars. How the Knowledge Base, AR patterns, Auditor+Investor, and Unified Engine fit together.

Explore →
CLI Reference

Complete reference for solve, run, status, inject, stop, and history.

View commands →
Configuration

Problem YAML fields, optimize_for, budget controls, and global config options.

Configure →
🧠
Learning System

How the Knowledge Base, AR patterns, UCB1 scoring, and the Librarian make the system genuinely improve over time.

Understand learning →
🤝
Contributing

How to contribute code, add team patterns to AR, improve the KB consolidation, or write new agent archetypes.

Contribute →

Quick Install

terminal
# Clone and install
git clone https://github.com/geopard-studio/nightshift.git
cd nightshift
pip install -e .
 
# Set your Anthropic API key
export ANTHROPIC_API_KEY="sk-ant-..."
 
# Run your first problem
nightshift run "analyze the performance bottleneck in main.py"
 
✓ Run complete · Quality: 4/5 · Cost: $0.38
✓ 8 KB entries written · patterns updated

All Pages