Show HN: Elf – A CLI Helper for Advent of Code

3•cak•2mo ago

I built a CLI tool called elf to streamline Advent of Code workflows. It removes a lot of the repetitive steps around fetching inputs, submitting answers safely, and checking private leaderboards.

The tool focuses on: - Input fetching with caching (no repeated downloads, works offline) - Safe answer submissions with guardrails to prevent duplicate or invalid guesses - Private leaderboard viewer (table or JSON) - Status calendar and guess history viewer - Optional Python API for scripting or automation

It’s built with Typer, httpx, Pydantic, and Rich, and aims to be clean, predictable, and easy to extend.

Repo: https://github.com/cak/elf

PyPI: https://pypi.org/project/elf/

Feedback and questions are welcome.

Comments

cak•2mo ago

Happy to answer any questions about design choices, caching strategy, the guardrails for safe submissions, or anything else. If anyone uses AoC in a team or automation setup, I’m especially interested in what features would help.

youchen_•2mo ago

This looks like a really useful tool for Advent of Code! The caching feature and offline support are great additions. Having a clean CLI interface makes the workflow so much smoother. Thanks for sharing!

cak•2mo ago

Thanks! Caching around inputs and submissions was a priority to keep the workflow fast and predictable. Happy to hear any feedback if you try it out. Really appreciate it, and happy puzzle solving!

ardata•2mo ago

Does the guess cache sync across machines at all, or is it purely local? I jump between my laptop and desktop for AoC and it'd be annoying to resubmit a 'too low' answer I already tried elsewhere.

cak•2mo ago

Sorry for the delay, I missed this! Great question. The guess cache is local by default, but you can set ELF_CACHE_DIR to point it at a shared folder like iCloud, Dropbox, Google Drive, or anything that syncs across your machines. That will keep your guess history unified so you do not risk resubmitting a too low or too high answer. Happy puzzle solving!

computersuck•2mo ago

I really like the clear explanation of caching behavior in the README. More open source projects should do this and save people time from searching forums or code base for "where does it store X"

cak•2mo ago

Thank you, that means a lot! I tried to make the caching behavior as transparent as possible so folks don’t have to dig through the code to figure out where things live. Really glad it helped, and happy to take suggestions if anything could be clearer.

The chaos in the US is affecting open source software and its developers

Trying to make an Automated Ecologist: A first pass through the Biotime dataset

Watch Ukraine's Minigun-Firing, Drone-Hunting Turboprop in Action

Free Trial: AI Interviewer

FDA Intends to Take Action Against Non-FDA-Approved GLP-1 Drugs

Supernote e-ink devices for writing like paper

We are QA Engineers now

Show HN: Measuring how AI agent teams improve issue resolution on SWE-Verified

Adversarial Reasoning: Multiagent World Models for Closing the Simulation Gap

Show HN: Poddley.com – Follow people, not podcasts

Layoffs Surge 118% in January – The Highest Since 2009

Papyrus 114: Homer's Iliad

DicePit – Real-time multiplayer Knucklebones in the browser

Turn-Based Structural Triggers: Prompt-Free Backdoors in Multi-Turn LLMs

Show HN: AI Agent Tool That Keeps You in the Loop

Why Every R Package Wrapping External Tools Needs a Sitrep() Function

Achieving Ultra-Fast AI Chat Widgets

Show HN: Runtime Fence – Kill switch for AI agents

Researchers surprised by the brain benefits of cannabis usage in adults over 40

Peter Thiel warns the Antichrist, apocalypse linked to the 'end of modernity'

USS Preble Used Helios Laser to Zap Four Drones in Expanding Testing

Show HN: Animated beach scene, made with CSS

An update on unredacting select Epstein files – DBC12.pdf liberated

Was going to share my work

Pitchfork: A devilishly good process manager for developers

You Are Here

Why social apps need to become proactive, not reactive

How patient are AI scrapers, anyway? – Random Thoughts

Vouch: A contributor trust management system

I built a terminal monitoring app and custom firmware for a clock with Claude

The chaos in the US is affecting open source software and its developers

Trying to make an Automated Ecologist: A first pass through the Biotime dataset

Watch Ukraine's Minigun-Firing, Drone-Hunting Turboprop in Action

Free Trial: AI Interviewer

FDA Intends to Take Action Against Non-FDA-Approved GLP-1 Drugs

Supernote e-ink devices for writing like paper

We are QA Engineers now

Show HN: Measuring how AI agent teams improve issue resolution on SWE-Verified

Adversarial Reasoning: Multiagent World Models for Closing the Simulation Gap

Show HN: Poddley.com – Follow people, not podcasts

Layoffs Surge 118% in January – The Highest Since 2009

Papyrus 114: Homer's Iliad

DicePit – Real-time multiplayer Knucklebones in the browser

Turn-Based Structural Triggers: Prompt-Free Backdoors in Multi-Turn LLMs

Show HN: AI Agent Tool That Keeps You in the Loop

Why Every R Package Wrapping External Tools Needs a Sitrep() Function

Achieving Ultra-Fast AI Chat Widgets

Show HN: Runtime Fence – Kill switch for AI agents

Researchers surprised by the brain benefits of cannabis usage in adults over 40

Peter Thiel warns the Antichrist, apocalypse linked to the 'end of modernity'

USS Preble Used Helios Laser to Zap Four Drones in Expanding Testing

Show HN: Animated beach scene, made with CSS

An update on unredacting select Epstein files – DBC12.pdf liberated

Was going to share my work

Pitchfork: A devilishly good process manager for developers

You Are Here

Why social apps need to become proactive, not reactive

How patient are AI scrapers, anyway? – Random Thoughts

Vouch: A contributor trust management system

I built a terminal monitoring app and custom firmware for a clock with Claude

Show HN: Elf – A CLI Helper for Advent of Code

Comments