#6857: docs: clarify that /elevated on is an alias for ask
docs
agents
Cluster:
Elevated Default Configuration Fixes
## Summary
The slash-commands quick reference and system prompt didn't explicitly mention that `on` and `ask` are equivalent for `/elevated`. This caused confusion — users couldn't determine what `on` does without consulting the source code or the dedicated elevated.md doc.
## Changes
- **docs/tools/slash-commands.md**: Add note that `on` is an alias for `ask` in the command list
- **src/agents/system-prompt.ts**: Update the elevated explanation from "ask runs exec..." to "on/ask run exec..."
## Context
Discovered while testing: asked what `/elevated on` does, and couldn't answer definitively because the system prompt only explained `ask` and `full`, not `on`.
The source code shows:
```typescript
export function resolveElevatedMode(level?: ElevatedLevel | null): ElevatedMode {
if (!level || level === "off") return "off";
if (level === "full") return "full";
return "ask"; // "on" maps here
}
```
## Testing
Verified source code behavior matches the documentation change.
---
🤖 *Built together with Claude. Fully tested, code reviewed and understood.*
Most Similar PRs
#19624: fix: elevatedDefault should default to off when tools.elevated.enab...
by stakeswky · 2026-02-18
63.9%
#19684: fix: change elevatedDefault fallback from 'on' to 'off'
by neipor · 2026-02-18
63.8%
#19595: fix: elevatedDefault should default to off when tools.elevated.enab...
by guirguispierre · 2026-02-18
63.1%
#18193: fix: default elevatedDefault to 'off' instead of 'on' (#18177)
by lailoo · 2026-02-16
60.3%
#20413: docs: clarify slash command authorization model and ownerAllowFrom
by mcinteerj · 2026-02-18
59.7%
#23752: Auto-reply: enforce per-session TTL elevated exec grants
by bmendonca3 · 2026-02-22
56.4%
#12834: docs(gateway): clarify there is no standalone clawrouter binary
by JBrady · 2026-02-09
55.5%
#3649: docs: remove numeric model selection references and document /models
by Jackten · 2026-01-29
55.1%
#12818: docs(messages): clarify message tool ordering vs inline replies
by JBrady · 2026-02-09
55.0%
#17221: fix(agents): prevent agents from using exec for gateway management
by CornBrother0x · 2026-02-15
54.1%