mode

mode is a command for Claude Code from Hassaan146/forge-mentor. It costs 17 tokens per session (497 once invoked), scanned A, original, MIT.

A command for choosing how much Forge decides and writes on its own. Its three modes control whether it confirms files, accepts edits automatically, or settles smaller choices itself.

In plain words
What is it for?
Use it to show or change the project's working mode between pipeline, accept-edits, and auto.
Why use it?
It lets you match the agent's level of independence to the task. You can require confirmation for careful work or reduce interruptions for routine edits.

Command for Claude Code

Written for Claude Code: argument-hint in frontmatter. Also seen: positional $N argument; mentions Claude Code.

Part of the forge plugin — 4 skills, 6 commands, 4 agents, 4 hooks, 1 MCP server shipped together

Good fit Use it to show or change the project's working mode between pipeline, accept-edits, and auto.

Compare 6 commands from other repositories ↓
Install with agentmods
npx agentmods add commands/hassaan146/forge-mentor/mode
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.

Clone the repo
git clone --depth 1 https://github.com/Hassaan146/forge-mentor

Made for: Claude Code.

Or install forge, the plugin that ships this one along with the rest of its 4 skills, 6 commands, 4 agents, 4 hooks, 1 MCP server.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for mode

README.md
[![agentmods](https://agentmods.dev/badge/commands/hassaan146/forge-mentor/mode.svg)](https://agentmods.dev/commands/hassaan146/forge-mentor/mode)
Your own site
<a href="https://agentmods.dev/commands/hassaan146/forge-mentor/mode"><img src="https://agentmods.dev/badge/commands/hassaan146/forge-mentor/mode.svg" alt="Measured on agentmods" height="20"></a>
Per session 17 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 497 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
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.1 $0.00017 $0.00497
Opus 5 $0.00009 $0.00249
Sonnet 5 $0.00003 $0.00099
Haiku 4.5 $0.00002 $0.00050

Measured 7d ago against content hash 86bca3d4a2e5, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

mode 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 7d ago.

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.

commands/mode.md · 41 lines

What it actually says

Change the working mode for this project, or show the current one if no mode was given.

The three differ in exactly one thing — how much gets decided for you (decision 030):

  • pipeline — asks about every decision that matters, and confirms each file before writing it
  • accept-edits — asks the same questions, and writes without stopping to confirm
  • auto — settles small things itself and records them; still asks about anything the rest of the work gets built on

What does not change: code can never move past a question that has not been answered, and the explain-back gate still runs. A mode that turned those off would not be a faster Forge — it would be plain Claude Code with a banner.

Requested mode: $1

Steps:

  1. Call next_step to read where the project currently stands.
  2. If $1 is empty, print the current mode and what it means through render_note, then ask which of the three they want through render_action with kind: "choose" — and stop there. A list of three modes with no framed ask is a paragraph, and the user is left to work out that a reply is expected.
  3. Otherwise call set_mode with it.
  4. Confirm the change in one line, using the plain-language meaning rather than the mode's name (rule R1 — the name tells a non-technical user nothing).
  5. If the new mode is auto, say plainly what Forge will now settle without asking, and what it will still stop for.

In auto mode, every settled choice goes through settle_small_decision. That is the whole mechanism: it writes the choice, what was picked, and that Forge picked it rather than the user. Settling something and moving on without it produces a project whose history says a human made a decision nobody remembers making, which is worse than not recording it at all (decision 030 accepts records nobody chose, on the condition that the two are never confused when read back). Load-bearing decisions still go to the user through render_decision in every mode.

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. 7d ago First seen · 41 lines · 17 tokens per session scan A 86bca3d4a2e5

Subscribe to this mod's changes

mode is a command published in the GitHub repository Hassaan146/forge-mentor (22 stars, last pushed 21d ago), licensed MIT. It adds 17 tokens to every session and 497 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-30.