The setup walkthrough shown on your assignment page
What’s Different From a Standard Assessment
- You’re given OpenCode, an AI coding assistant that runs in your terminal, with an AI usage budget already funded for you
- Your AI session is recorded as part of your submission — the AI reviews how you worked with the assistant, not just your final code
- Everything else works the same: same deadline, same ZIP upload, same “you can’t resubmit once you’re done”
Setting Up Your Workspace
Your assignment page gives you two ways to get set up. Pick whichever you’re more comfortable with — they end up in the same place.Automatic Setup
Pick your editor and operating system:
Choosing your operating system and editor before the install command is generated
- Windows (PowerShell):
irm "<your assignment's install link>" | iex - Mac/Linux (bash):
curl -fsSL "<your assignment's install link>" | bash
- Creates (or uses) a workspace folder on your machine and initializes a local git repository in it
- Installs the OpenCode CLI, if you don’t already have it
- Requests an AI credential using your invitation, and writes it into OpenCode’s configuration
- Installs a small plugin that tags your AI session so it can be identified during review — it doesn’t carry any login credentials of its own and doesn’t restrict what you can do with the assistant
- Downloads your problem statement into the folder as
problem_statement.md - Writes a small submit script (
submit.shon Mac/Linux,submit.ps1on Windows) you can run later to upload your work - Sets up your editor: for VS Code, it adds a couple of one-click tasks (open the problem statement, start the assistant, submit your work) and opens the folder for you; for Zed, IntelliJ, or Visual Studio, it launches that editor and starts the assistant in a terminal; for any other editor, it leaves the folder ready and tells you where it is
If You’re Using VS Code
The first time VS Code opens your workspace, it may open in Restricted Mode and ask you to trust the folder before tasks or extensions can run:
VS Code asking you to trust the workspace before tasks can run
opencode ., and open problem_statement.md from the file explorer instead.
Manual Setup
If you’d rather do each step yourself instead of running the install command:Install a code editor and the OpenCode CLI
Get your AI key
~/.config/opencode/opencode.json (Windows: %USERPROFILE%\.config\opencode\).Install the session plugin
~/.config/opencode/plugins/hr-session-header.js. Without it, your session isn’t recorded and your work can’t be reviewed.Get the problem statement
problem_statement.md.Open the folder and start OpenCode
opencode . in a terminal.Submit your work
Submitting Your Work
Same as a standard assessment — package your project as a ZIP and upload it (see Packaging Your ZIP File). If you used the automatic setup, you can also run the generatedsubmit.sh/submit.ps1 script, or use the “Submit assessment” task from inside VS Code if it was set up for you.

The "Submit assessment" task, available from the VS Code command palette