Exit codes

Something went wrong: git failed, a file or line doesn’t exist, the config is invalid, or you cancelled.

The command can’t go on as asked: it was used wrongly, a check failed, or it needs a terminal. The message says which. Every command that reads chamoji.config.json also exits 2 when its release section is from a newer chamoji.

Nothing to release. Only next-version and release use it.

0. A bare chamoji, --help and --version always exit 0. An unknown command exits 2.

0 when it printed or wrote the changelog. 1 for anything else, such as an unknown --format, or --unit in a repo without release units.

0 when it printed a version. 3 when no commit since the last tag implies a bump. In a monorepo, 0 when any unit would release and 3 when none would, and 2 for a shallow clone it couldn’t unshallow or a version file it can’t set.

0 when it released, or the dry run worked. 3 when there is nothing to release. 2 when a check failed: a dirty working tree, the wrong branch, a version that isn’t semver or isn’t newer, a first release with no version, a tag that already exists, or a shallow clone it couldn’t unshallow. In a monorepo, also a version file it can’t set, or a version that differs from its fixed group’s. 1 for anything else, such as a failed push.

0 when it saved, or nothing would change. 2 when something would change and there is no terminal and no --yes, or --json and no --yes, when the hook step finds another tool’s hook, and for a release section from a newer chamoji. 1 when you cancel, for a step name it doesn’t know, or when a step fails.

0 when it committed. 2 when there is no terminal to ask on. 1 when you cancel, or git refuses the commit.

0 for install and uninstall, including when install only prints the line for core.hooksPath and when there was no hook to remove. 2 when install finds another tool’s hook and leaves it alone, and with no action or an unknown one. 1 outside a git repo, or when anything else fails. The hook itself, hook run, always exits 0, so it never blocks a commit.

0 when it worked. 2 when it was used wrongly, such as an unknown subcommand. 1 for anything else, such as a workstream that doesn’t exist.

0 when it found the commit, and for a line you haven’t committed yet. 2 with no location, or more than one. 1 for anything else, such as a location that isn’t file:line, a file or line that doesn’t exist, or a repo with no commits yet.

0 when it worked, including a search with no matches. 2 when it was used wrongly, such as an unknown subcommand, a missing slug or query, or an extra argument, and for search --ai with no TypeSafe key. 1 for anything else, such as an entry that doesn’t exist or is already archived, or sync with no origin or a failed fetch or push.

0 when it printed the URL or the numbers. 2 for a release section from a newer chamoji. 1 for anything else, such as a repo it can’t tell, an --endpoint that isn’t an http(s) URL, or a --to ref that doesn’t exist.

0 when memory sharing is set up, when there is no origin to share with, and when the fetch from origin fails, which it reports on stderr. 1 when --agents can’t safely change or write .mcp.json or .claude/settings.json, outside a git repo, or when anything else fails.

0 when the agent closes the connection. 2 when it’s given arguments. 1 for anything else.