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