Hackathon Co-pilot

reading settings
font:
size:
spacing:

A Claude Code agent in a Telegram group that tracks my hackathon deadlines and checks each submission against its requirements.

Hackathon Co-pilot

What changed

  • Replaced five browser tabs with one question. "What's due?" returns every deadline in my timezone with the time left and the most urgent task.
  • Checked submissions before I sent them. "Is bountypay ready?" verifies that the repo is public, has a license and has a live demo, and lists what's still missing.
  • Kept the answers exact. Dates and checks come from a script, and Claude only decides what I'm asking for and explains the result.

What I worked on

  • I built it for the Flip the Switch hackathon, using Switch to run a Claude Code agent on my laptop and put it in a Telegram group.
  • I wrote the checker in Python with only the standard library. It reads one TOML file of hackathons and runs each requirement's check in parallel.
  • I set the agent's limits in its standing instructions. It never submits forms, posts for me or changes a repo's visibility.

I entered five hackathons in November 2026, with deadlines on the 7th, 11th, 12th, 14th and 20th. Each had its own submission form, video length and repo rules, in a different timezone. Now I ask a Telegram group from my phone.

How it works

Switch connects a Telegram bot to a server on my laptop. When I address the agent in the group, the server starts a Claude Code session in the repo and relays messages both ways.

The repo is the agent's whole world. hackathons.toml lists each hackathon with its deadline, UTC offset, repo and requirements. copilot.py reads that file: brief prints the countdowns and check runs each requirement's check and prints one verdict per line.

The co-pilot checking whether BountyPay is ready to submit

A requirement can be manual, or one the script verifies: the repo is public, GitHub recognises a license, the README mentions a phrase, a demo URL is up, or I've starred a repo. When I tell the agent a video is uploaded, it marks the requirement done in the file and commits the change. When I paste a new hackathon's URL, it reads the rules page and adds one requirement per rule.

Limits

The agent answers only when I message it, because Switch has no scheduled messages yet. It runs on my laptop, so when the laptop sleeps the group gets no answers.