cut-release

A release command for the arterm project that prepares a version’s changelog entry, commits it, and creates its Git tag. A tag is a fixed label in version control that marks a released code state.

In plain words
What is it for?
It is for cutting a new arterm release from the main branch, recording what changed, and creating the release tag through the project’s release script.
Why use it?
It checks that the requested version, repository state, remote branch, existing tags, and continuous-integration results are ready before releasing, helping prevent incomplete or duplicate releases.

Command for Claude Code

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/arclude/arterm-cli/cut-release
Clone the repo
git clone --depth 1 https://github.com/Arclude/Arterm-CLI

Made for: Claude Code.

Per session 22 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,168 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00022 $0.01168
Opus 5 $0.00011 $0.00584
Sonnet 5 $0.00004 $0.00234
Haiku 4.5 $0.00002 $0.00117

Measured yesterday against content hash 1ebca2c11fe8, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

cut-release scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/commands/cut-release.md · 112 lines

How it starts

The opening of the file, as written. The whole thing — 112 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Cut release $ARGUMENTS of arterm.

The changelog entry is the point of this command. scripts/generate_release_notes.sh renders changelog/v<version>.json into the GitHub release body when it exists, and silently falls back to raw commit subjects when it does not — which is how v0.9.0 through v0.10.3 shipped with contributor shorthand as their release notes. Do not reach the tagging step without the entry written and validated.

1. Preconditions

Stop and report if any of these fail — do not "fix" them as part of the release:

  • The version argument is present and looks like vX.Y.Z. If it is missing, ask which version to cut; do not infer one.
  • The tag does not already exist locally or on origin (git tag -l, git ls-remote --tags origin).
  • You are on main, the working tree has no tracked modifications, and main is level with origin/main.
  • CI is green on the commit being released: gh run list --branch main --limit 3. A red or in-progress run means stop and say so.

2. Read what the release contains

scripts/changelog_entry.py commits $ARGUMENTS

This lists every non-merge commit since the previous tag. Commits whose conventional-commit prefix is internal (test, ci, chore, refactor, style, build, gate) are marked [internal?] as a drafting hint — read them, do not trust the mark blindly, and never filter silently.

Read the actual diffs where a subject is not self-explanatory. The commit log is the source of truth; the changelog is a user-facing layer over it.

3. Write changelog/v<version>.json

Follow the schema and writing guidelines in changelog/README.md. In short:

  • Describe the effect on the user, not the implementation.
  • One sentence per item.
  • highlights holds only the 1-3 changes a user would actually notice. Everything else goes in improvements or fixes.
  • Omit empty arrays entirely. Omit title unless the release has an obvious theme.
  • Skip internal-only changes. If the whole release is internal, say so in a single improvements item rather than padding the entry.
  • version is the number without the leading v; date is today in YYYY-MM-DD.

Read the full file on GitHub · 112 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 112 lines · 22 tokens per session scan A 1ebca2c11fe8

Subscribe to this mod's changes

cut-release is a command published in the GitHub repository Arclude/Arterm-CLI (2 stars, last pushed yesterday), licensed MIT. It adds 22 tokens to every session and 1,168 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.