mcpField
M
monitoring-terminal-errors

monitoring-terminal-errors

github.com/revitalb-portDevelopment066 installsUpdated 11w ago
Repository

About monitoring-terminal-errors

A development skill for watching a running process’s terminal output, locating errors in source files, and iterating on fixes until the process recovers or five attempts fail.

Key features

  1. 01Finds the terminal running a target process
  2. 02Recognizes common runtime and build errors
  3. 03Extracts file paths and line numbers
  4. 04Guides edits and recovery checks
  5. 05Stops after five unsuccessful attempts

Use cases

  1. 01Debugging a development server during coding
  2. 02Fixing test runner errors as they appear
  3. 03Resolving build failures and checking hot reload

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/revitalb-port/skills-registry-demo --skill monitoring-terminal-errors

After installing, type/monitoring-terminal-errorsin Claude Code to confirm it loaded.

Details

From the project README

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
  1. Read the identified file around the error line
  2. Understand the error (missing import, type mismatch, undefined variable, etc.)
  3. Apply the fix
  4. 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

Comments

Markdown supported