a prompt is the shortest distance between a question and an answer

The solver shell

It is running on the right — yours, and only yours: forked the first time you connect, and still there when you come back.

at the prompt

96

every command

92

Command Catalogue

Every shell command on one page: name, aliases, the least profile that may run it, and what it does. It is the short form — each name links into commands-index.md, which carries the same command's full ? panel (usage, arguments, the whole description).

This page exists so the catalogue has one home rather than only a section inside another guide: the web front end's terminal page renders it beside the shell, and the User Guide shows the same table in its own narrative. All three are the same block, generated from the live registry by the update-docs command — do not edit it by hand. To change what a row says, edit the command's docstring or its @register declaration and run update-docs.

Requires is the least profile that may run the command; every rung above it may too, and below it the command is not registered at all, so it does not appear in your own ? listing. What four columns cannot show — whether a command takes a problem number, whether it supports --silent, what it asks for — is in its index entry, one click along its name.

In every shell — solver, the web shell and solver-host:

Command Aliases Requires Description
! sh, bash contributor Run a shell command from the shell, returning its exit code.
? help reader List every command, or show detailed help for one command.
benchmark — contributor Measure and record the execution time of the problem's solutions.
blog — reader List a blog article's declared tags and what each one maps to.
blogs — reader List a problem's tags and the blog articles that cover them.
check-commands — admin Report every command docstring that breaks the documented standard.
claude — contributor Run Claude Code interactively in the repository root, returning its exit code.
claude-api — contributor Generate one of a problem's solution artifacts through the Claude API.
claude-batch — maintainer Bulk-tag a wave of problems in one Message Batches job, at half price.
claude-blog — maintainer Write (or flesh out) a blog article via the claude-euler-blogger skill.
claude-login — contributor Sign Claude Code in, then report whether it is, returning 0 only when signed in.
claude-solve — contributor Run Claude Code over a problem's solution files, via a skill.
clear cls reader Clear the terminal screen and scrollback, then succeed.
compile-c compile contributor Compile every C solution for the problem into a runnable binary.
costs — contributor Print what this session's AI tokens have cost, per model.
create-blog — maintainer Seed a curated cross-cutting blog page.
echo — reader Print the given text to the console, then succeed.
edit ed contributor Open a solution file in the web code editor.
evaluate eval contributor Evaluate a problem's solutions against its test cases.
gh-merge merge maintainer List the open pull requests, or rebase-merge one onto master.
git-audit audit contributor Audit what git actually stores, across the whole tracked tree.
git-commit commit contributor Stage and commit the named targets — the one commit verb.
git-filter filter reader Report or wire the transparent encryption filter for solutions/private.
git-hooks hooks contributor Run the git pre-commit and (simulated) pre-push checks on demand.
git-identity identity contributor Configure your git identity and push credential from your GitHub login.
git-publish publish maintainer Publish changed files for named targets to the remote repository.
git-push push contributor Push the current branch to origin as yourself, then open its pull request.
git-reset reset reader Soft-reset your branch to origin/master — un-commit, keep every change.
git-status status reader Display the sync state between the local branch and origin/master.
git-sync sync reader Bring the local repository in sync with origin/master.
host-unlock — admin Take the mailed block from host-authorize and unlock this machine.
key-export — admin Print the master key sealed to a machine's public key, to carry there yourself.
key-reconstruct — reader Unwrap the half you were sent, complete it from the repository, store the key.
key-rekey rekey admin Rotate the master key and re-encrypt every private file under the new one.
lint — contributor Lint the problem's solution files, optionally auto-fixing them.
ls — reader List the files in a problem's solution directory.
mark mark-solved contributor Mark the current problem as solved — once its results confirm it.
new — contributor Generate new solution and/or test-case files for the problem.
pause — reader Wait for the user to press Enter before the block carries on.
pip-upgrade upgrade admin Upgrade packages in the current venv for the given dependency groups.
problems — reader Print a list of problems and their count.
progress — reader Print overall progress through the Euler problems.
random — reader Return a random whole number from min to max, both included, as the exit code.
results — reader List the recorded results for a problem.
search find reader Search the solution stack for a case-insensitive regular expression.
show open, view reader Open a problem's page, or any site page, in a browser or the web viewer panel.
sleep — reader Wait the given number of seconds before the block carries on.
summary — maintainer Refresh the solved/unsolved state from your Project Euler progress page.
sys-setup install admin Install or uninstall a system resource.
tags — reader Report over the central tag vocabulary (blogs/tags.json).
test-cases — reader List a problem's test cases.
tool-setup — contributor Install, uninstall or reinstall a per-user tool in your own home.
update-docs — admin Rebuild the registry-generated blocks in the docs/ guides and the README.
update-models — admin Refresh the model catalogue and its pricing.
update-presentation-data — maintainer Refresh the presentation deck's data from the progress file.
update-tags — contributor The glue for the double-entry tag graph.
update-usd-rate — maintainer Refresh the USD→EUR rate used to report API costs.
user — reader Show the solver user, the current identity, and whether it can decrypt.
vault — reader Encrypt this user's id + env at rest under a password-derived vault key.
version — reader Print the installed build version, plus live git detail of the clone.

On the web host only — loaded by the web shell and solver-host, which have the message spool, the roster and the mail relay these need:

Command Aliases Requires Description
host-authorize — admin Mail the master key, sealed to one machine's public key — the off-host grant.
key-split — maintainer Send someone half the master key, sealed to their public key.
logout — reader Sign out of the web session, after a short countdown the notice can skip.
logout-all — admin Sign every web user out, after a countdown that running work can extend.
msg messages reader Read and send messages: what is waiting for you, and what it asks you to do.
user-authorize authorize maintainer Record someone's public key and send them half the master key.
users — admin Administer accounts on the authorization map + the auth service.

What the web shell changes

The web shell runs these same commands with an overlay table on top (packages/webshell/euler_webshell/shell/overlays.toml; docs/package-guide.md § 3.2): a few run a different body — show and edit swap the page's left pane instead of opening a browser tab — and the ones that change state refresh the part of the page they changed. Generated from that table by update-docs.

Command In the web shell
git-commit then refreshes the git chip
git-push then refreshes the git chip
git-sync then refreshes the git chip
git-reset then refreshes the git chip
git-filter then refreshes the git chip
git-publish then refreshes the git chip
key-reconstruct then refreshes the git chip
host-unlock then refreshes the git chip
gh-merge then refreshes the git chip, the message chip
update-docs then refreshes the git chip
update-tags then refreshes the git chip
update-models then refreshes the git chip
update-usd-rate then refreshes the git chip
update-presentation-data then refreshes the git chip
summary then refreshes the solutions grid, the git chip
mark then refreshes the solutions grid, the git chip
user then refreshes the account page
git-identity then refreshes the account page
claude-login then refreshes the account page
tool-setup then refreshes the account page
show runs euler_webshell.shell.viewer.show instead
edit runs euler_webshell.shell.viewer.edit instead
key-rekey runs euler_webshell.shell.keys.key_rekey instead; then refreshes the git chip