@maximoai/maximo-syntax-cli 0.1.17 → 0.1.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +41 -0
  2. package/dist/cli.mjs +8038 -4872
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -97,6 +97,47 @@ You can also update right from inside the CLI:
97
97
 
98
98
  ---
99
99
 
100
+ ## Permission modes (auto & always-approve)
101
+
102
+ Maximo Syntax can run with fewer (or no) permission prompts. There are **two different modes**:
103
+
104
+ | Mode | How to enable | Classifier? | Notes |
105
+ |------|---------------|-------------|--------|
106
+ | **Default (ask)** | *(default)* | No | Prompts for risky tools; read-only work is free |
107
+ | **Accept edits** | Shift+Tab | No | File edits in the project without prompts |
108
+ | **Plan** | `/plan` or Shift+Tab | No | Read-only planning until you approve |
109
+ | **Auto (classifier)** | `/auto` → pick **Auto · classifier**, or `--permission-mode auto` | **Yes** | Safe tools run; risky ones are classified first. Footer: `◎ auto · classifier on` |
110
+ | **Always-approve (YOLO)** | `/auto` → pick **Always-approve**, or `/yolo`, `--always-approve`, `--yolo` | **No** | Almost no prompts — **sandbox/VM recommended**. Footer: `⚠ always-approve · no classifier on` |
111
+
112
+ **In the TUI, run `/auto`** and choose which version you want (classifier, always-approve, or off). Aliases `/yolo` and `/always-approve` open the same picker. The prompt footer and Shift+Tab toast show the active mode; `/status` lists it too.
113
+
114
+ ### Classifier auto mode
115
+
116
+ - Available when you are logged in via **Maximo AI** or **MyTabulon**.
117
+ - Uses your **currently selected model** as the classifier (same login credentials).
118
+ - **Warning:** each classified tool call is an extra API request and **consumes additional usage-pool quota** beyond the main agent.
119
+ - Deny rules and hooks still apply. Prefer a sandbox for long unattended runs.
120
+
121
+ ```bash
122
+ maximo --permission-mode auto
123
+ # or in the TUI:
124
+ /auto
125
+ ```
126
+
127
+ ### Always-approve (no classifier)
128
+
129
+ ```bash
130
+ maximo --always-approve
131
+ maximo --yolo
132
+ # or in the TUI:
133
+ /always-approve
134
+ /yolo
135
+ ```
136
+
137
+ Deny rules and PreToolUse hooks still apply. There is **no** safety classifier — only use this when you trust the environment.
138
+
139
+ ---
140
+
100
141
  ## Images: paste and drag-and-drop
101
142
 
102
143
  You can attach images to a prompt by **copy-paste** or by **dragging and dropping** a file into the terminal — both work the same way: