advent-of-code

My solutions to https://adventofcode.com

Nushell overlay (advent-of-code.nu)

This repository includes advent-of-code.nu — a Nushell script that adds helpers and shortcuts for working with the Advent of Code workspace.

You can load those helpers into your current Nushell session temporarily, or install them as a persistent overlay so they're available every time you start Nushell.

Quick (temporary) — load into the current session

From Nushell, run:

overlay use ./advent-of-code.nu

After that you can call the helpers (examples below) in the same shell session.

Important prerequisites

• Nushell installed (nu)
• Rust toolchain + Cargo (for building/running solutions)
• For get-input to work you must set the AOC_SESSION environment variable with your Advent of Code session cookie.
• For upload-gist you must have the GitHub CLI (gh) configured & authenticated.

Example helper commands

After loading the overlay (see above), here are common examples:

• Run a solution (runner crate): run Advent of Code 2015 day 1

aoc 2015 1

• Run tests for a specific day (quiet):

aoc test 2015 1

• Watch source files and re-run a day on change:

aoc watch 2015 1

• Download puzzle input for a day (requires AOC_SESSION):

get-input 2015 1

• Create a new year crate skeleton:

new-year 2025

• Create a new day module for a year (also fetches the input):

new-day 2025 1

• Upload a day's solution file to a GitHub Gist:

upload-gist 2015 1

• Generate a YouTube description from a stage progress JSON:

youtube-desc path/to/2015-13.json

Troubleshooting

• If a command fails with authentication errors, double-check AOC_SESSION (for get-input) or that gh auth status shows you are logged in (for upload-gist).
• If a helper is not found after installing the overlay, either source the file manually in your session or restart Nushell.

Enjoy — and happy coding!