mentormates

Hackathon companion CLI. Submit your build session and check event info — straight from the terminal, zero install.

Works with any agent — Claude Code, Codex, Kimi Code, OpenClaw, Hermes, Cursor. Anything that can run a shell command. Bring your own.

npx mentormates            # banner + commands
npx mentormates info       # hackathon details: schedule, links
npx mentormates submit     # bundle your build session and submit it

submit

Pick what to submit — a Claude Code session from ~/.claude/projects/, a Codex session from ~/.codex/sessions/, a Kimi Code session from ~/.kimi-code/sessions/ (or ~/.kimi/sessions/), a Cursor workspace from its workspaceStorage/ (chat + Composer history lives in state.vscdb), or your current project directory (so any agent's build works). The CLI zips it (pure-JS, no system zip; node_modules/.git skipped, source left intact), then uploads it.

Authentication is a per-participant submit token — grab yours from your profile on the event site, or set MENTORMATES_TOKEN. The token identifies you, so there's no email to type.

If the upload fails it prints the path to the local zip so you can submit it manually — nothing is lost.

The API base URL defaults to https://seahack.mentormates.ai; override it with MENTORMATES_API_URL.

Flags (LLM-agent friendly)

Every prompt has a matching flag, so submissions can be driven non-interactively by an agent or a script. Any flag that's provided skips its prompt; with -y, missing required inputs error out instead of prompting.

npx mentormates submit \
  -y \
  --project .                          # number, path, or substring
  --token "$MENTORMATES_TOKEN" \
  --name "My Project" \
  --repo https://github.com/me/proj \
  --description "What I built" \
  --transcript ./agent.log \           # or a URL — see below
  --json                                # machine-readable result on stdout

--transcript accepts either a local path (file or directory — included in the zip) or a shareable URL (sent as a form field). Use a URL when your agent runs in the browser and you can only share a chat link.

Joining a teammate's submission instead of starting a new project:

npx mentormates submit -y --project . --token "$T" --join-code ABC123 --json

--json emits {ok: true, projectId, joinCode, hasAgentLogs, projectsUrl, archive} on success or {ok: false, error, archive} on failure (exit code 1). Use npx mentormates info --json to get event details as structured data.

info

Prints the bundled hackathon details — name, date, venue, schedule, and key links. Aliased as event.

Requirements

Node 18 or newer.

License

MIT