Monitoring Terminal Errors
Continuously watch a running process (dev server, test runner, build) for errors and fix them as they appear.
Workflow
1. Identify the Terminal
List terminal files and find the one running the target process:
head -n 10 <terminals_folder>/*.txt
Look for terminals running dev servers (npm run dev, pnpm dev, python manage.py runserver, etc.).
2. Read Terminal Output
Read the full terminal file content. Search for error patterns:
- Stack traces:
at <function> (<file>:<line>:<col>)
- Node.js:
Error:, TypeError:, ReferenceError:, ENOENT, ECONNREFUSED
- Python:
Traceback (most recent call last): followed by File "<path>", line <n>
- React/Next.js:
Unhandled Runtime Error, Error: ..., Module not found
- Build errors:
ERROR in, Failed to compile, SyntaxError
- Vite:
[vite] Internal server error:
- TypeScript:
error TS\d+:
3. Extract the Source Location
From the stack trace, extract:
- File path
- Line number
- Error message
For Node.js: at functionName (/path/to/file.ts:42:10)
For Python: File "/path/to/file.py", line 42, in function_name
4. Navigate and Fix
- Read the identified file around the error line
- Understand the error (missing import, type mismatch, undefined variable, etc.)
- Apply the fix
- Re-read the terminal file to confirm the server recovered (hot reload should pick it up)
5. Loop
If the server is still showing errors after the fix, repeat from step 2. Stop when:
- The terminal shows a clean "compiled successfully" or equivalent
- No new errors appear in the output
- You've made 5 attempts without resolution (report to user)
Tips
- Check for
exit_code in the terminal file footer — if present, the process has crashed entirely and needs a restart
- Some errors cascade — fix the first/root error and the rest often disappear
- For HMR errors, the fix might just be saving the file again to trigger a rebuild
1---2name: monitoring-terminal-errors3description: Watch running terminal processes for crashes and stack traces. When an error appears, navigate to the failing file and line, diagnose, and fix it automatically.4---5
6# Monitoring Terminal Errors
7
8Continuously watch a running process (dev server, test runner, build) for errors and fix them as they appear.
9
10## Workflow
11
12### 1. Identify the Terminal
13
14List terminal files and find the one running the target process:
15
16```bash
17head -n 10 <terminals_folder>/*.txt
18```
19
20Look for terminals running dev servers (`npm run dev`, `pnpm dev`, `python manage.py runserver`, etc.).
21
22### 2. Read Terminal Output
23
24Read the full terminal file content. Search for error patterns:
25
26- **Stack traces**: `at <function> (<file>:<line>:<col>)`
27- **Node.js**: `Error:`, `TypeError:`, `ReferenceError:`, `ENOENT`, `ECONNREFUSED`
28- **Python**: `Traceback (most recent call last):` followed by `File "<path>", line <n>`
29- **React/Next.js**: `Unhandled Runtime Error`, `Error: ...`, `Module not found`
30- **Build errors**: `ERROR in`, `Failed to compile`, `SyntaxError`
31- **Vite**: `[vite] Internal server error:`
32- **TypeScript**: `error TS\d+:`
33
34### 3. Extract the Source Location
35
36From the stack trace, extract:
37- File path
38- Line number
39- Error message
40
41For Node.js: `at functionName (/path/to/file.ts:42:10)`
42For Python: `File "/path/to/file.py", line 42, in function_name`
43
44### 4. Navigate and Fix
45
461. Read the identified file around the error line
472. Understand the error (missing import, type mismatch, undefined variable, etc.)
483. Apply the fix
494. Re-read the terminal file to confirm the server recovered (hot reload should pick it up)
50
51### 5. Loop
52
53If the server is still showing errors after the fix, repeat from step 2. Stop when:
54- The terminal shows a clean "compiled successfully" or equivalent
55- No new errors appear in the output
56- You've made 5 attempts without resolution (report to user)
57
58## Tips
59
60- Check for `exit_code` in the terminal file footer — if present, the process has crashed entirely and needs a restart
61- Some errors cascade — fix the first/root error and the rest often disappear
62- For HMR errors, the fix might just be saving the file again to trigger a rebuild