@hasna/terminal 1.6.5 → 1.6.6
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 +35 -3
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -183,12 +183,44 @@ Every command through `terminal exec` goes through:
|
|
|
183
183
|
6. **Structured Parsing** — JSON instead of text
|
|
184
184
|
- Git status/log, test results, build output, npm install, errors
|
|
185
185
|
|
|
186
|
+
## Best Practices for 95%+ Reliability
|
|
187
|
+
|
|
188
|
+
Tested across 149 queries by 3 independent agents on 3 different repos:
|
|
189
|
+
|
|
190
|
+
```bash
|
|
191
|
+
# Session start (100% reliable)
|
|
192
|
+
terminal repo # Git status + recent commits
|
|
193
|
+
terminal "ls packages/" # Package overview (monorepo)
|
|
194
|
+
terminal symbols src/main.ts # Key file structure
|
|
195
|
+
|
|
196
|
+
# Code exploration (use path hints!)
|
|
197
|
+
terminal "in src/lib, what functions are exported" # Path hint = 80%+ reliability
|
|
198
|
+
terminal "grep -rn 'pattern' src/" # Command passthrough works too
|
|
199
|
+
terminal symbols src/db/tasks.ts # 100% reliable on valid files
|
|
200
|
+
|
|
201
|
+
# Git queries (100% reliable, any phrasing)
|
|
202
|
+
terminal "what changed in the last 3 commits"
|
|
203
|
+
terminal "who made the most recent change"
|
|
204
|
+
|
|
205
|
+
# System queries (100% reliable)
|
|
206
|
+
terminal "how many typescript files"
|
|
207
|
+
terminal "what testing framework is used"
|
|
208
|
+
terminal "show me the package.json scripts"
|
|
209
|
+
```
|
|
210
|
+
|
|
211
|
+
**Key rules:**
|
|
212
|
+
- Include package/directory paths in your query for best results
|
|
213
|
+
- Use `terminal symbols <file>` for file outlines (100% reliable)
|
|
214
|
+
- Use `terminal repo` at session start (replaces 3 git commands)
|
|
215
|
+
- For literal commands: `terminal "grep -rn pattern src/"` works with answer framing
|
|
216
|
+
- Git and system queries work with any phrasing
|
|
217
|
+
|
|
186
218
|
## CLI Commands
|
|
187
219
|
|
|
188
220
|
```
|
|
189
|
-
terminal
|
|
190
|
-
terminal
|
|
191
|
-
terminal repo Git
|
|
221
|
+
terminal "your request" NL → AI runs command → smart answer
|
|
222
|
+
terminal Launch interactive NL terminal (TUI)
|
|
223
|
+
terminal repo Git status + diff + log in one call
|
|
192
224
|
terminal symbols <file> File outline (functions, classes, exports)
|
|
193
225
|
terminal stats Token economy dashboard
|
|
194
226
|
terminal sessions List recent sessions
|
package/package.json
CHANGED