torben/chemenu
1
1 Fork 0
Code Issues 40 Pull Requests Actions Packages Releases 41 Wiki Activity
Page: Reference Exit codes
Pages
Dev Development Explanation Architecture Explanation Configuration tiers Explanation Knowledge and commitment Explanation Language boundaries Explanation Model and effort selection Explanation Ownership and templates Explanation Pipeline rationale Explanation Telemetry and evaluation Explanation Version model Explanation Why gates are code Explanation Home How to Back up to a synced folder How to Browse with obsidian How to Capture repository docs How to Collect from a synced folder How to Export guidelines How to Export to a synced folder How to Fetch pages behind a login How to Ingest a source How to Maintain the wiki How to Query the wiki How to Run the weekly review How to Set up the mcp server How to Trace and score sessions How to Troubleshoot How to Update an instance How to Use 1password for settings How to Write a site handler How to Install Reference Commands Catalog and log Reference Commands Configuration Reference Commands Content migrations Reference Commands Distribution and versioning Reference Commands Exports Reference Commands Finding and checking Reference Commands Git Reference Commands Instance health Reference Commands Links and citations Reference Commands Pages Reference Commands Provenance Reference Commands Raw material and uploads Reference Commands Telemetry Reference Commands Types instructions and docs Reference Commands Workshop runs and session budget Reference Commands Reference Configuration Reference Exit codes Reference Page types Reference Skills Reference Tutorials First source to first answer Tutorials Sample source Tutorials
Clone
3
Reference Exit codes
Wiki Mirror edited this page 2026-10-16 14:43:37 +00:00
Unescape Escape
Table of Contents
This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Generated from docs/reference/exit-codes.md at v10.1.0 – edit the repository, not this wiki.

Exit codes and gates

Which wikitool commands can stop and wait for a person - exit 42 - and for which gate, generated from the command records.

What each exit code means, and how a caller reacts to it, is AGENTS.md § Tool error contract. What a gate is and why it is enforced in code is AGENTS.md § Gates. This page lists which commands declare a gate, and every cause for which a command exits 42.

Gates by command

guideline-push

mass-update

publish-remote

rebase-review

upload-review

Exit 42 causes

  • new: new project: The provider cannot create the project itself (Super Productivity's access: "api"); the output says what a human has to create
  • task new: The tracker settings file of an earlier version is still there, or a secret source (1Password) needs unlocking
  • task list: The tracker settings file of an earlier version is still there, or a secret source (1Password) needs unlocking
  • task close: The tracker settings file of an earlier version is still there, or a secret source (1Password) needs unlocking
  • review: The tracker settings file of an earlier version is still there, or a secret source (1Password) needs unlocking
  • raw fetch: The host is fetched with the user's session and none is stored, or the page arrived without the sign of being signed in that its site handler names (the session expired)
  • raw fetch: The site handler declares render and the optional browser component is not installed
  • raw login: The optional browser component is not installed
  • upload accept: Upload Review Gate: --confirm is absent or does not match the manifest's current token
  • sync: Rebase-Review Gate: <remote>/<branch> moved and both sides changed the same file, generated files aside; the output lists the upstream commits, the overlapping files and their diff
  • publish: The remotes settings file of an earlier version is still there
  • publish: Mass-Update Gate: --threshold (default 10) or more counted files would be committed, or the --confirm token does not match this changeset
  • publish: Rebase-Review Gate: <remote>/<branch> moved and both sides changed the same file; the output lists the upstream commits, the overlapping files and their diff
  • publish: Publish-Remote Gate: remotes.allowed_push_urls is set and the push URL of --remote is not listed in it, or --remote resolves to no push URL
  • export guidelines: Guideline Push Gate: --push without --confirm, or with a token that does not match the current set of targets
  • config set: The field names a program to run or affects a gate