Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (watchfix) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

watchfix

CLI tool that watches logs, detects errors, and dispatches AI agents to fix them.

Features

Log watching: Monitor file logs, command output, or Docker container logs
Error detection: Configurable patterns to identify errors in your logs
AI-powered fixes: Automatically dispatch Claude, Gemini, or Codex to analyze and fix errors
Context awareness: Generates relevant context files for AI agents
Deduplication: Groups similar errors to avoid redundant fixes
Daemon mode: Run in the background on Linux/macOS

Installation

npm install -g watchfix

Requirements

Node.js 18+
One of the following AI CLI tools:

Quick Start

Initialize a configuration file in your project:

watchfix init

Edit watchfix.yaml to configure your log sources and error patterns:

version: "1"

sources:
  - name: app
    type: file
    path: ./logs/app.log

patterns:
  - name: node-error
    regex: "Error: .+"
    severity: error

agent:
  provider: claude

Start watching logs:

watchfix watch

When an error is detected, fix it:

watchfix fix <error-id>

Autonomous Mode

For fully automated error fixing without manual approval:

watchfix watch --autonomous

In autonomous mode, watchfix automatically dispatches AI agents to fix detected errors. Combine with daemon mode for background operation (Linux/macOS):

watchfix watch --daemon --autonomous

Note: Manual watchfix fix commands are blocked while running in autonomous mode.

CLI Commands

Command	Description
`watchfix init`	Create `watchfix.yaml` in current directory
`watchfix watch`	Watch logs in foreground (use `--daemon` for background, `--autonomous` for auto-fix)
`watchfix fix [id]`	Analyze and fix a specific error (or `--all` for all pending)
`watchfix show <id>`	Show full error details and analysis
`watchfix status`	Show watcher state and pending errors
`watchfix stop`	Stop background watcher
`watchfix ignore <id>`	Mark error as ignored
`watchfix logs`	Show activity log
`watchfix clean`	Remove old context files
`watchfix config validate`	Validate configuration file

Global Options

-c, --config <path>: Use alternate config file
--verbose: Increase output verbosity
-q, --quiet: Suppress non-essential output

Platform Notes

Daemon mode (watchfix watch --daemon) is only available on Linux and macOS
Windows users should run watchfix watch in a terminal window or use a process manager

Documentation

For detailed configuration options and advanced usage, see the specification document.

For a working example project, see watchfix-example.

License

MIT