Hackathon Manager

Hackathon Manager

Track multiple hackathons with deadlines, prizes, and submission checklists. Automatically extract hackathon details from URLs and manage progress toward submission.

Quick Start

Run commands using the manager.py script:

python scripts/manager.py <command> [args]

Core Commands

Add a Hackathon

python scripts/manager.py add "Hackathon Name" "YYYY-MM-DD" "Prize Amount"

Example:

python scripts/manager.py add "Solana Agent Hackathon" "2026-02-12" "$50K"

From URL: When given a hackathon URL, use web_fetch to extract:

• Hackathon name
• Deadline date
• Prize pool
• Submission requirements

Then call add command with extracted info and populate checklist.

List All Hackathons

python scripts/manager.py list

Shows table with name, deadline, status, and progress for all tracked hackathons.

View Status

python scripts/manager.py status "Hackathon Name"

Shows detailed view including full checklist with completion status.

Check Off Item

python scripts/manager.py check "Hackathon Name" "Item text or number"

Mark a checklist item as complete. Accepts either:

• Full item text: check "Solana Agent" "Deploy to devnet"
• Item number: check "Solana Agent" "2"

View Upcoming

python scripts/manager.py upcoming [days]

Show hackathons due in next N days (default 7). Sorted by urgency with visual indicators.

Text Calendar View

python scripts/manager.py calendar [month] [year]

Display a text calendar with hackathon markers:

• R = Registration opens
• W = Work period starts
• D = Submission deadline

Google Calendar Integration

Sync hackathons to Google Calendar using the gog CLI. Requires gog to be installed and authenticated.

List Calendar Events

python scripts/manager.py gcal list

Show all hackathon-related events currently in Google Calendar.

Sync to Calendar

python scripts/manager.py gcal sync

Create Google Calendar events for all tracked hackathons:

• [REG] - Registration opens (timed event)
• [WORK] - Work period (all-day event)
• [DEADLINE] - Submission deadline (timed event)

Remove from Calendar

python scripts/manager.py gcal remove "Hackathon Name"

Delete all calendar events matching the hackathon name.

Note for Windows: The skill auto-configures the Go timezone database. If you get timezone errors, ensure ~/.gog/zoneinfo.zip exists.

Workflow

When user mentions hackathons:

1. Adding from URL: If they provide a hackathon link:

   • Use web_fetch to get the page
   • Extract name, deadline, prize, requirements
   • Run add command
   • Populate checklist with requirements

2. Manual add: If they provide details:

   • Run add command with provided info
   • Ask what checklist items to track

3. Checking status: If they ask "what's due?" or "what hackathons?":

   • Run list or upcoming command
   • Show relevant information

4. Managing progress: If they mention completing something:

   • Identify the hackathon and item
   • Run check command
   • Confirm completion

Data Storage

Hackathons stored in JSON at: ~/.openclaw/workspace/hackathons.json

Structure:

{
  "hackathons": [
    {
      "name": "Hackathon Name",
      "deadline": "YYYY-MM-DD",
      "prize": "$50K",
      "status": "active",
      "checklist": ["Item 1", "Item 2"],
      "completed": ["Item 1"]
    }
  ]
}

Integration with HACKATHONS.md

When HACKATHONS.md exists in workspace:

• Read it to discover hackathons not yet in the JSON store
• Suggest importing them
• Keep both files in sync when adding new hackathons

Notes

• Data stored in ~/.openclaw/workspace/hackathons.json
• Google Calendar integration requires gog CLI
• Events are prefixed with [REG], [WORK], or [DEADLINE] for easy identification
• The gcal remove command matches hackathon name in event titles