askii-cli 0.2.4 → 0.2.5
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.
- package/README.md +62 -20
- package/dist/index.js +651 -272
- package/package.json +3 -1
package/README.md
CHANGED
|
@@ -100,14 +100,14 @@ askii do --dir .\my-project "refactor index.ts"
|
|
|
100
100
|
|
|
101
101
|
The agent can use the following actions each round:
|
|
102
102
|
|
|
103
|
-
| Action | Description
|
|
104
|
-
| -------- |
|
|
105
|
-
| `list` | List files in a folder (`[file]` / `[folder]` labels)
|
|
106
|
-
| `view` | Read a file's contents
|
|
107
|
-
| `create` | Create a new file
|
|
108
|
-
| `modify` | Replace text in an existing file
|
|
109
|
-
| `rename` | Rename or move a file
|
|
110
|
-
| `delete` | Delete a file
|
|
103
|
+
| Action | Description | Requires confirmation |
|
|
104
|
+
| -------- | ----------------------------------------------------- | --------------------- |
|
|
105
|
+
| `list` | List files in a folder (`[file]` / `[folder]` labels) | No |
|
|
106
|
+
| `view` | Read a file's contents | No |
|
|
107
|
+
| `create` | Create a new file | Yes |
|
|
108
|
+
| `modify` | Replace text in an existing file | Yes |
|
|
109
|
+
| `rename` | Rename or move a file | Yes |
|
|
110
|
+
| `delete` | Delete a file | Yes |
|
|
111
111
|
|
|
112
112
|
The loop continues after every round — not only after reads — until the AI returns `[]` or the round limit is hit.
|
|
113
113
|
|
|
@@ -138,6 +138,7 @@ askii control -p lmstudio --lmstudio-model llava-1.5 "open the browser"
|
|
|
138
138
|
```
|
|
139
139
|
|
|
140
140
|
Each round the AI can return one of:
|
|
141
|
+
|
|
141
142
|
- **mouse_move** — move the cursor to `(x, y)`
|
|
142
143
|
- **mouse_left_click** — left-click at `(x, y)`
|
|
143
144
|
- **mouse_right_click** — right-click at `(x, y)`
|
|
@@ -148,20 +149,61 @@ Without `--yes`, each proposed action is shown with its reasoning and requires `
|
|
|
148
149
|
|
|
149
150
|
---
|
|
150
151
|
|
|
152
|
+
### `browse` — Browser agent
|
|
153
|
+
|
|
154
|
+
Launches a Puppeteer browser, takes a screenshot of the current page and its URL, sends both to the AI, and executes the returned action. Repeats until the AI returns `DONE` or `--max-rounds` is reached. Requires a **vision-capable model** (e.g. `llava`, `moondream2`).
|
|
155
|
+
|
|
156
|
+
By default the browser window is **visible**. Pass `--headless` to run in the background.
|
|
157
|
+
|
|
158
|
+
**bash**
|
|
159
|
+
|
|
160
|
+
```bash
|
|
161
|
+
askii browse --ollama-model llava "go to https://example.com and click Learn more"
|
|
162
|
+
askii browse --yes --ollama-model llava "search Google for Node.js and open the first result"
|
|
163
|
+
askii browse --headless --yes --ollama-model llava "check the title of https://github.com"
|
|
164
|
+
askii browse --max-rounds 10 --ollama-model llava "fill in the login form on example.com"
|
|
165
|
+
askii browse -p lmstudio --lmstudio-model llava-1.5 "go to news.ycombinator.com"
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
**PowerShell**
|
|
169
|
+
|
|
170
|
+
```powershell
|
|
171
|
+
askii browse --ollama-model llava "go to https://example.com and click Learn more"
|
|
172
|
+
askii browse --yes --ollama-model llava "search Google for Node.js and open the first result"
|
|
173
|
+
askii browse --headless --yes --ollama-model llava "check the title of https://github.com"
|
|
174
|
+
askii browse --max-rounds 10 --ollama-model llava "fill in the login form on example.com"
|
|
175
|
+
askii browse -p lmstudio --lmstudio-model llava-1.5 "go to news.ycombinator.com"
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
Each round the AI can return one of:
|
|
179
|
+
|
|
180
|
+
- **goto** — navigate to a URL
|
|
181
|
+
- **click** — click an element by CSS selector
|
|
182
|
+
- **type** — type text into an element by CSS selector (clears existing value first)
|
|
183
|
+
- **wait_for** — wait until a CSS selector appears in the DOM
|
|
184
|
+
- **back** — navigate back in browser history
|
|
185
|
+
- **forward** — navigate forward in browser history
|
|
186
|
+
- **DONE** — task complete, stop the loop
|
|
187
|
+
|
|
188
|
+
Without `--yes`, each proposed action is shown with its reasoning and requires `y` confirmation before executing.
|
|
189
|
+
|
|
190
|
+
---
|
|
191
|
+
|
|
151
192
|
## Options
|
|
152
193
|
|
|
153
|
-
| Flag
|
|
154
|
-
|
|
|
155
|
-
| `--platform`
|
|
156
|
-
| `--ollama-url`
|
|
157
|
-
| `--lmstudio-url`
|
|
158
|
-
| `--ollama-model`
|
|
159
|
-
| `--lmstudio-model`
|
|
160
|
-
| `--mode`
|
|
161
|
-
| `--max-rounds`
|
|
162
|
-
| `--dir`
|
|
163
|
-
| `--code`
|
|
164
|
-
| `--yes`
|
|
194
|
+
| Flag | Short | Description | Default |
|
|
195
|
+
| ------------------ | ----- | ------------------------------------------------ | ------------------------ |
|
|
196
|
+
| `--platform` | `-p` | LLM platform: `ollama`, `lmstudio` | `ollama` |
|
|
197
|
+
| `--ollama-url` | | Ollama server URL | `http://localhost:11434` |
|
|
198
|
+
| `--lmstudio-url` | | LM Studio server URL | `ws://localhost:1234` |
|
|
199
|
+
| `--ollama-model` | | Ollama model | `gemma3:270m` |
|
|
200
|
+
| `--lmstudio-model` | | LM Studio model | `qwen/qwen3-coder-30b` |
|
|
201
|
+
| `--mode` | | Response style: `helpful`, `funny` | `funny` |
|
|
202
|
+
| `--max-rounds` | | Max agent rounds for `do` / `control` / `browse` | `5` |
|
|
203
|
+
| `--dir` | | Working directory for `do` | cwd |
|
|
204
|
+
| `--code` | `-c` | Code input (alternative to stdin) | |
|
|
205
|
+
| `--yes` | `-y` | Auto-confirm all actions | |
|
|
206
|
+
| `--headless` | | Run Puppeteer headlessly for `browse` | `false` (visible) |
|
|
165
207
|
|
|
166
208
|
## Environment Variables
|
|
167
209
|
|