victauri-watchdog 0.2.1

Lightweight crash-recovery sidecar for Victauri MCP server
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

# victauri-watchdog

Lightweight crash-recovery sidecar for the [Victauri](https://github.com/runyourempire/victauri) MCP server.

Since Victauri's MCP server runs inside the Tauri app process, a crash kills the server too. The watchdog runs as a separate process, detects failures, and can trigger recovery.

## What It Does

- Polls `GET /health` on the Victauri MCP server at a configurable interval
- Logs warnings on first failure, errors after consecutive misses
- Executes a configurable recovery command after threshold failures
- Resets failure count automatically when the server recovers

## Installation

```bash
cargo install victauri-watchdog
```

## Usage

```bash
# Default: poll localhost:7373 every 5 seconds
victauri-watchdog

# Custom port and interval
VICTAURI_PORT=8080 VICTAURI_INTERVAL=10 victauri-watchdog

# With recovery command (runs after 3 consecutive failures)
VICTAURI_ON_FAILURE="systemctl restart my-tauri-app" victauri-watchdog
```

## Environment Variables

| Variable | Default | Description |
|---|---|---|
| `VICTAURI_PORT` | `7373` | Port to poll for health checks |
| `VICTAURI_INTERVAL` | `5` | Seconds between health checks |
| `VICTAURI_MAX_FAILURES` | `3` | Consecutive failures before recovery action |
| `VICTAURI_ON_FAILURE` | _(none)_ | Shell command to execute on failure threshold |

The recovery command fires once per failure cycle. If the server comes back, the counter resets.

## Documentation

Full API docs: [docs.rs/victauri-watchdog](https://docs.rs/victauri-watchdog)

## License

Apache-2.0 -- see [LICENSE](../../LICENSE)

Part of [Victauri](https://github.com/runyourempire/victauri). Built by [4DA Systems](https://4da.ai).