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:
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:
- reads your team and your repository;
- 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;
- checks Git, Docker, the Docker daemon and Compose;
- 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;
- writes the agent files (
--agent claude-code, the default, or--agent codex); - starts the app with Docker Compose and waits until it is ready;
- prints the local app URL, the dashboard URL and a summary.
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 listshows 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-demoplays 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-pitchskill); - 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-voteskill); your team is a vote candidate once it is set.
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.