fix: coupy sources and pin linux/amd64

1 files changed, 18 insertions, 3 deletions

diff --git a/README.md b/README.md
index b9e1eed..afa8008 100644
--- a/README.md
+++ b/README.md
@@ -6,16 +6,31 @@ I don't particularly care about the AoC leaderboard. December is usually a prett
 AoC gives each user their own puzzle input. I keep my inputs locally and do not commit them to this repository. If you're running these solutions yourself, you'll need to provide your own inputs in whatever format the corresponding solution expects.

 

 ## Docker

-To build the Docker image, run this from the repository root:

+The solutions are Linux x64 ELF binaries, so they don't run natively on macOS or Windows. The image bundles `nasm`, `ld`, and `make`. It's pinned to `linux/amd64`; on Apple Silicon it runs under emulation automatically (you'll see a harmless platform-mismatch warning).

+

+Build the image from the repository root:

 

 ```sh

 docker build -t aoc .

 ```

 

-To run a specific day:

+List the available days:

+

+```sh

+docker run --rm aoc list

+```

+

+### Inputs

+AoC inputs are per-user and are not committed to this repo. Put your input for a given day at `input/dayN.txt` in the repository root, then mount that directory when running so the solution can read it:

+

+```sh

+docker run --rm -v "$PWD/input:/app/input" aoc day5

+```

+

+Assemble and link every day without running it — a quick build check that needs no input:

 

 ```sh

-docker run --rm aoc YEAR=2025 DAY=5

+docker run --rm aoc all

 ```

 

 When you're done, remove the image with: