Read Advent of Code puzzle descriptions, download puzzle input, submit answers and check if they are correct, all from the comfort of your terminal.
```
aoc-cli relies on openssl-sys, which
requires OpenSSL libraries and headers for compiling it. On Linux, you need
to install a package with OpenSSL development headers such as libssl-dev or
openssl-devel.
aoc-cli with cargo:
```
```
On macOS and Linux, use Homebrew:
```
```
On Windows 10 and 11, use the Windows Package Manager command line tool:
```
```
Executables for selected platforms are available in GitHub releases. Simply download and extract the file. An installer is also available for Windows.
The Linux package is statically-linked with OpenSSL and musl C library, and it should just work on most Linux distributions.
The macOS and Windows packages should automatically detect installed OpenSSL libraries. The MSVC Windows packages require the redistributable Visual C++ runtime library, whereas the MinGW packages require the Minimalist GNU for Windows runtime libraries.
aoc-cli-<version>-x86_64-unknown-linux-musl.tar.gzaoc-cli-<version>-x86_64-apple-darwin.tar.gzaoc-cli-<version>-x86_64.msiaoc-cli-<version>-x86_64-pc-windows-msvc.zipaoc-cli-<version>-x86_64-pc-windows-gnu.zipaoc-cli-<version>-i686-pc-windows-msvc.zipaoc-cli-<version>-i686-pc-windows-gnu.zipDifferent Advent of Code users get different puzzle input. To download your
input and submit your answer, you need an adventofcode.com session cookie. To
obtain your session cookie, login to the
Advent of Code website and inspect the session
value of the cookie that gets stored in your browser - see instructions
here.
The session cookie (a long hex string) must be provided in a single line (no
line breaks) in one of the following ways (listed in order of precedence):
1. In a file specified via the --session-file command line option.
2. In an ADVENT_OF_CODE_SESSION environment variable.
3. In a file called .adventofcode.session (note the dot) in your home
directory (/home/alice on Linux, C:\Users\Alice on Windows,
/Users/Alice on macOS).
4. In a file called adventofcode.session (no dot) in your user's config
directory (/home/alice/.config on Linux, C:\Users\Alice\AppData\Roaming
on Windows, /Users/Alice/Library/Application Support on macOS).
```
Advent of Code command-line tool
Usage: aoc [OPTIONS] [COMMAND]
Commands: read Read puzzle statement (the default command) [aliases: r] download Save puzzle description and input to files [aliases: d] submit Submit puzzle answer [aliases: s] private-leaderboard Show the state of a private leaderboard [aliases: p] help Print this message or the help of the given subcommand(s)
Options:
-d, --day
```
Submit puzzle answer
Usage: aoc submit [OPTIONS]
Arguments:
Options:
-d, --day
Read today's puzzle (if today is an Advent of Code day) in plain text from the comfort of your terminal.
```
[INFO aoc] 🎄 aoc-cli - Advent of Code command-line tool
The Elves begin to set up camp on the beach. To decide whose tent gets to be closest to the snack storage, a giant [Rock Paper Scissors][1] tournament is already in progress. ... ```
Download description and input for today's puzzle and save them to files. By default the description is saved to "puzzle.md" and the input is saved to "input" in the current directory:
```
[INFO aoc] 🎄 aoc-cli - Advent of Code command-line tool [INFO aoc::aoc] 🎅 Saved puzzle description to 'puzzle.md' [INFO aoc::aoc] 🎅 Saved puzzle input to 'input' ```
Submit the answer to part 1 of today's puzzle (in this example, the answer is 999):
```
[INFO aoc] 🎄 aoc-cli - Advent of Code command-line tool
That's the right answer! You are one gold star closer to saving your vacation. [[Continue to Part Two]][1]
[1] /2022/day/2#part2 ```
If you are a member of a private leaderboard, you can see how you are faring against your friends by passing the leaderboad number:
```
[INFO aoc] 🎄 aoc-cli - Advent of Code command-line tool Private leaderboard of me & my friends for Advent of Code 2022.
Gold * indicates the user got both stars for that day, silver * means just the first star, and a gray dot (.) means none.
1111111111222222
1234567890123456789012345
1) 274 **.*.... Emery Zboncak 2) 254 ****....... Whitney Effertz 3) 134 *............ Ezra Parisian 4) 72 ............... Asha Gerlach 5) 54 *............... Frederik Robel 6) 20 *.................. Graciela Herzog 7) 0 ................... Thad Prohaska ```
Any non-ambiguous prefix of a command can be used instead of the full command
name. For instance:
- Instead of aoc read, type aoc r, aoc re or aoc rea.
- Instead of aoc download, type aoc d, aoc do, aoc dow, aoc down, etc.
- Instead of aoc submit, type aoc s, aoc su, aoc sub, etc.
- Instead of aoc private-leaderboard, type aoc p, aoc pr, aoc pri etc.
Download puzzle from a previous day (assumes the current year):
```
```
Download puzzle input from a previous year and save it to a file with a given name:
```
```
An attempt to download a puzzle that is still locked fails (puzzles unlock every day between 1st and 25th of December at midnight EST/UTC-5):
```
[INFO aoc] 🎄 aoc-cli - Advent of Code command-line tool [ERROR aoc] 🔔 Puzzle 25 of 2030 is still locked ```
Submit the answer to a previous year: ```
```
Specify path to session cookie file: ```
```
Feedback and pull requests are welcome. Please see CONTRIBUTING for guidelines and ideas.
Advent of Code is a free online Advent calendar of small programming puzzles created by Eric Wastl and maintained by volunteers. Please consider supporting their work.