monkeyscode-cli 1.1.12 → 1.2.0

package/README.md

@@ -297,12 +297,29 @@ What the agent **may do** (permission mode + rules) and how hard the model
 **thinks** (effort) are separate settings.
 
 ```bash
-mc --permission-mode acceptEdits "refactor utils"     # default | acceptEdits | plan | bypass
+mc --permission-mode acceptEdits "refactor utils"     # default | acceptEdits | auto | plan | bypass
 mc -p "fix tests" --headless --allowed-tools "run_command(npm test:*)" "edit_file(src/**)"
 mc --effort high "find the race condition"            # low | medium | high
 ```
 
-In a session: Shift+Tab cycles `default` → `acceptEdits` → `plan`, `/plan` jumps to plan mode, `/effort high` changes
+In a session the current mode is always shown at the bottom of the screen
+(and as `[Manual]` etc. on the prompt in the plain REPL):
+
+| Mode | Stored as | What runs without asking |
+|------|-----------|--------------------------|
+| **Manual** | `default` | Reads only; every edit and command asks |
+| **Accept edits** | `acceptEdits` | File edits inside the workspace; commands still ask |
+| **Auto** | `auto` | Edits and commands. Still asks for destructive commands, anything outside the workspace, shell it can't verify and your `ask` rules |
+| **Plan** | `plan` | Nothing changes: research and propose a plan |
+| **Bypass** | `bypass` | Everything, destructive commands included; deny rules still apply. Only for throwaway environments |
+
+`/mode` opens a picker; `/mode auto`, `/mode accept-edits` etc. switch
+directly, and `--save` keeps it as your starting mode. Shift+Tab cycles
+Manual → Accept edits → Auto → Plan (Bypass joins the cycle with
+`cycleBypass`, which `mc setup` offers). `mc setup` also picks the starting
+mode, or set `permissions.defaultMode`. Managed settings can disable Bypass
+(`disableBypassPermissionsMode`); Auto stays available. The old v1 settings key
+`"mode": "auto"` still means Manual. `/plan` jumps to plan mode, `/effort high` changes
 effort from the next request, and `/permissions` lists every effective rule
 and the file it came from. Print/headless runs are non-interactive: they do
 not open TTY approval dialogs. By default, calls that would ask are denied
@@ -374,7 +391,7 @@ The 54 visible built-ins below follow the default registry and its full
 | Command | Usage | Description |
 |---------|-------|-------------|
 | `/model` | `/model [id]` | Show or switch the model |
-| `/mode` | `/mode <plan\|fast\|thinking>` | Switch legacy mode; prefer effort for fast/thinking |
+| `/mode` | `/mode [manual\|accept-edits\|auto\|plan\|bypass] [--save]` | Show (picker) or switch the permission mode; `--save` makes it the starting mode |
 | `/plan` | `/plan` | Research and propose without edits |
 | `/ask` | `/ask` | Read-only Q&A about the codebase |
 | `/effort` | `/effort [low\|medium\|high\|default]` | Show or set reasoning effort |
@@ -450,6 +467,7 @@ The 54 visible built-ins below follow the default registry and its full
 | `/bug` | `/bug` | Diagnostic context for a bug report |
 | `/doctor` | `/doctor` | System health check |
 | `/config` | `/config [key [value]]` | Show/change user settings |
+| `/notifications` | `/notifications [on\|off\|test\|status]` | OS alerts when a task finishes or needs you (aliases `/notify`, `/alerts`) |
 | `/update` | `/update [check]` | Check for or install updates |
 | `/help` | `/help` | Show live help |
 
@@ -532,11 +550,19 @@ and context size, and Enter switches to the highlighted one.
 The ⌥ keys work with your terminal's default settings (Terminal.app, iTerm2,
 VS Code, kitty, WezTerm, Ghostty, Windows Terminal). You can click a tab and
 scroll with the wheel in every tab: the wheel scrolls whichever pane is under
-the pointer (chat history, the Changes column, Diff, Code Review). Hold Shift
-(⌥ in iTerm2 and Terminal.app) while dragging to select text, or use `/copy`
-for the last answer. Set `mouse` to `tabs` to keep the mouse to Diff / Code
-Review (plain drag selects in Chat, but the wheel no longer scrolls it), or to
-`off` to turn the mouse off.
+the pointer (chat history, the Changes column, Diff, Code Review).
+
+**Selecting and copying:** drag with the mouse to select text. The selection
+stays inside the pane where you started (the chat history, the Changes column
+or the input box), so selecting the chat never picks up the diff beside it.
+Hold the drag above or below the chat or the Changes column to scroll it and
+keep selecting (further from the edge scrolls faster). Selected text keeps its
+colours, drawn in inverse. It's copied to the clipboard when you release the
+button, and a notice confirms it. Any key clears the highlight. Hold Shift (⌥ in iTerm2 and
+Terminal.app) while dragging for the terminal's own selection, which spans
+the whole screen width. `/copy` copies the last answer. Set `mouse` to `tabs`
+to keep the mouse to Diff / Code Review (the terminal selects in Chat, but the
+wheel no longer scrolls it), or to `off` to turn the mouse off.
 
 **In-app chat scrolling:** The chat viewport is internally scrollable — the
 composer and status line stay fixed while you navigate history. Use the mouse