Solvewright connector

Practise live technical interviews in Solvewright Interview Lab with the Claude Code or Codex you already use. The interviewer runs on your computer, under your own sign-in and plan. Solvewright provides the room: the problem, the editor, the tests, the conversation, your history and your skill profile.

uvx solvewright

No uv? pipx run solvewright works the same way, or python3 -m pip install --user solvewright and then solvewright. Python 3.10 or newer. The package has no dependencies.

What happens when you run it

1. The terminal lists this computer, the agents it found and where interviews are kept.
2. It prints a short code and opens solvewright.app/connect. Check that the page shows the same code, then press Connect this computer. You must be signed in to Solvewright.
3. The terminal says which account it joined. Keep the window open while you practise; it prints one line for each thing it does (a round prepared, a reply, tests recorded).
4. Press Ctrl+C to stop. Nothing keeps running in the background, and nothing starts again by itself.

Next time, run the same command again: it reconnects without a new code, and the terminal reminds you which command that is. uvx and pipx run keep the package in a cache and add no solvewright command to your shell, so with them, put uvx or pipx run in front of the commands below (for example uvx solvewright status). Removing this computer from Interview Lab stops its key at once.

What it can and cannot do

The connector is deliberately small. Every request it accepts is one of a fixed list: report its status, start a round, pass your message to the interviewer, save your files, record a test result, stop the interviewer, and sync your history. There is no request that runs a command.

• It opens no port. It connects out to Solvewright over HTTPS and asks for work.
• It only takes requests from your account. This computer's key is issued after you approve it in the browser, is stored only here (connection.json, readable by you alone), and the service keeps a hash of it.
• It never sees your Claude or ChatGPT credentials. It starts the official claude or codex program, unmodified, which signs in the way it always does. Usage counts against your own plan.
• It never runs your code. Public tests and the interviewer's private checks run in your browser, in Pyodide (Python compiled to WebAssembly); the page shows each check's label and result, never its code. The connector only stores the files you tested and the results.
• It reports progress, not content. While the interviewer works, the page learns which kind of step it is on (reading your code, writing its notes, running its checks), never what it reads, writes or says. It also passes on your plan's usage when the agent reports it (Codex's usage windows, Claude Code's rate-limit events), read without a model call, so replies can use less effort when your window is nearly spent.
• It does not update itself. What runs is the version you installed from PyPI. The interviewer's instructions ship inside the package (src/solvewright/interviewer/), so you can read exactly what your agent is told.

The interviewer's sandbox

The interviewer writes the problem and checks its own reference solution, so it needs to run code. It does that inside its own agent's sandbox, confined to the folder of the current round:

Claude Code runs with --restricted --safe-mode --strict-mcp-config: your own CLAUDE.md, hooks, plugins and MCP servers are not loaded. Codex runs through its documented app-server with its plugins, apps, hooks, web search, memories and every MCP server you configured switched off for the interview. If a platform cannot provide one of these limits, the connector removes the capability rather than the limit, and says so in the terminal and in Interview Lab. On Linux, Claude Code's sandbox needs bubblewrap and socat.

What is stored where

On this computer, in one folder (solvewright status prints it):

Each round is a folder holding the candidate files, the interviewer's private files, snapshots of what you submitted, and the conversation. When you are signed in, Interview Lab also keeps a copy in your Solvewright account so you can continue on another computer; deleting your account deletes it. Your agent sends what it reads to its own provider (Anthropic or OpenAI) under your account's terms, as it does in any other session. Details: solvewright.app/privacy.

Read the code

About 1,800 lines of Python in src/solvewright/:

The account service address and its publishable key are in settings.py. They are the same public values every visitor's browser receives from solvewright.app.

Run the tests from this folder with PYTHONPATH=src python -m unittest discover -s tests (on Windows, set PYTHONPATH=src first).

Licence

MIT. Solvewright is not affiliated with Anthropic or OpenAI. Claude Code and Codex are their respective owners' products; this program runs the versions you installed.