Skip to main content
This page walks a participant through the hackathon, from installing the plugin to ranking the other teams. Your team is one project of the event, and a solo entrant is a team of one.

The fast way: one prompt

Paste the prompt of Start here into your coding agent: it does steps 1 to 4 with you. The steps below are the same thing by hand. The hackathon skills install in any agent with one command:
hackathon-doctor runs the checks of step 4, walks you through what they say and reads the clock of step 6. hackathon-deck-demo, hackathon-deck-pitch and hackathon-deck-vote make your team’s three decks from the organizers’ templates, host them on Slideless and hand their links to the platform (step 9). The skills are public, at github.com/antasphere-hackathon/plugin. Either way, an organizer has put your email on the roster and added you to the event’s organization at account.antasphere.com. Sign in with that email: the roster is matched on it. The hackathon opens only to the organizations Antasphere grants it; Who can sign in says what that means for you. Without Claude Code, or to see what the plugin runs, the steps below are the same thing by hand.

1. Install the command line

The command line is the npm package @antasphere/hackathon, and its command is hackathon:

2. Sign in and connect

login asks for your Antasphere email, then for the code it sends you. That is your Antasphere account, the one that opens every Antasphere tool, and it is stored once on this machine: antasphere login from the account CLI, if you use it, signs in the same way and to the same place. The command knows where the hackathon lives, https://app.hackathon.antasphere.com, so it takes no URL. connect checks that the roster names you, then prints who you are, your team, your repository (not assigned yet until the organizers have created it), the dashboard URL and the next command. An account the roster does not name is refused: ask an organizer to add the email you sign in with. An account whose organizations do not open the hackathon reads the refusal Antasphere gives, and the command exits with code 3 (Who can sign in). Your team’s repository invites your GitHub account. If the roster has no GitHub username for you, or the wrong one, name yours:
GitHub then sends you an invitation to the repository, by email and on the repository’s page. Accept it with that same GitHub account before you set up.

3. Set up your team’s app

setup clones your team’s repository into ~/Antasphere/hackathon/<your-team>. To put it somewhere else, name the folder: hackathon setup --directory ~/code/my-team. It prints each command before it runs it:
  1. reads your team and your repository;
  2. checks that GitHub lets your account push to the repository. If you have not named your GitHub username yet, or the invitation is still waiting, it stops and tells you what to do;
  3. checks Git, Docker, the Docker daemon and Compose;
  4. clones your team’s repository with your own Git access. An existing clone of the right repository is kept as it is: it is never reset and no change is discarded;
  5. writes the agent files (--agent claude-code, the default, or --agent codex);
  6. starts the app with Docker Compose and waits until it is ready;
  7. prints the local app URL, the dashboard URL and a summary.
Running setup again is safe. It resumes where it stopped and keeps your work. A repository whose app needs a local secret to start, as the Malt × Antasphere starter’s database password, gets its .env written by setup: the lines of .env.example, with that secret generated (readable by you only). A value already set in .env is never changed. Your own API keys stay yours to add to .env; restart the app after (docker compose -p hackathon-<team> up -d).

4. Check your machine

doctor changes nothing. It checks Git and the name and email your commits carry, Node.js 22 or later, Docker, the Docker daemon, Compose, the free disk space, your sign-in, your place on the roster, your repository and your access on GitHub, then your clone and the app. If you cloned outside the default folder, pass it: hackathon doctor --directory ~/code/my-team. It also proves that you can push: it runs git push --dry-run in your clone, so GitHub checks your access with the credential of this machine, and nothing is sent. If GitHub refuses, doctor says which account GitHub saw. Accept the invitation with the account on the roster, or sign in to GitHub on this machine with that account (gh auth login, or an SSH key on it). Each failed check prints what to do, written for your system: macOS, Linux or Windows. Every command exits with a code that says what went wrong; the table is on The commands.

5. Build and push

Work in your clone and push to your team’s designated branch. setup and the Home page’s submission card name it. What counts is the last push the platform received before the freeze, not the last commit on your machine. Read The clock, the grace and the freeze before the event. In short:
  • push early, and push often;
  • after a push, open the Home page and check Last received revision on your submission card against git rev-parse HEAD. hackathon submissions list shows the same line;
  • the build ends at the build end. You then have exactly 15 minutes of grace to push your final changes. At the freeze, intake closes: a push received from then on is recorded and never counts.

6. Watch the clock

The Home page shows the phase, a countdown to the next deadline and every deadline in the event’s time zone, and a small timer stays on every page. The countdown follows the server’s clock, not your device’s. The notices appear 15, 5 and 1 minute before the build end, at the start of the grace, 5 and 1 minute before the freeze, and at the freeze. If an organizer moves the build end, you see a notice with the reason. From the command line: hackathon event status.

7. Your team’s chat and the help requests

The Chats page lists the channels open to you: the general one, your team’s chat, and the thread of each of your team’s help requests. Your team, the coaches and the organizers read your team’s chat. No other team does. Each channel works like a team chat app. Reply to a message in its thread, so the channel keeps only its top-level messages. Edit or delete your own messages. React with an emoji, and mention anyone who reads the channel with @. New messages, reactions and who is typing appear live, without a reload. When you are stuck, open a request: a one-line title and what you need. A coach claims it and answers in its thread. When it is sorted, anyone on your team resolves it; the thread then reads only, until someone reopens the request. From the command line: hackathon requests open --title "…" --body "…", hackathon chats list, hackathon chats post <channelId> <your words>.

8. The feed

The general channel is the event’s feed. The organizers pin announcements at the top. Organizers, participants and coaches post plain text, up to 4000 characters; the jury reads nothing here. From the command line: hackathon feed list and hackathon feed post <your words>.

9. Hand in your three decks

Before the pitches, your team hands in three Slideless share links, each a deck started from the template the organizers published in your organization’s Slideless workspace:
  • the demo deck: your app shown working in one to three episodes of real screenshots, read by the jury alone (hackathon-deck-demo plays your running app with Playwright and takes them);
  • the presentation: the pitch one of you gives on stage, three to five minutes (the hackathon-deck-pitch skill);
  • the vote presentation: your elevator pitch with the gaps filled, read by the other participants on the Vote page before they rank the teams (the hackathon-deck-vote skill); your team is a vote candidate once it is set.
Each skill fills its template from your repository, checks it on a laptop and a phone, publishes it on Slideless with a share link and registers the link for you. By hand:
Any link alone updates just that link. The Teams page shows every team’s Demo deck, Presentation and Vote presentation. What each deck holds, and how the vote works, is on Decks and the community vote.

10. Rank the other teams

When the organizers turn the vote on and open it, the Vote page lists every other team. Your own team is listed apart: you cannot rank it.
  • Order the teams, best first.
  • Save draft keeps a ranking in progress. It may be incomplete.
  • Submit ballot needs every other team exactly once. You can submit again until the vote closes; the last submission replaces the one before. Only a submitted ballot counts.
You have one ballot. After the close, an organizer releases the result, and it appears on the same page.