watchman

Runs in-session audit, report, monitor, fix, and stats commands for Linux and macOS host monitoring.

2|Updated Jun 14, 2026
One-click install
npx skills add https://github.com/odysseyalive/claude-watchman --skill watchman-odysseyalive
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: watchman
Source: https://github.com/odysseyalive/claude-watchman/tree/main/commands/watchman
Command: npx skills add https://github.com/odysseyalive/claude-watchman --skill watchman-odysseyalive

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Server and workstation operators need ongoing visibility into security posture, crashes, capacity, and log anomalies without dashboards or alert fatigue, and they need remediation that never performs destructive actions without explicit confirmation. ## Core Features & Use Cases - Audit and inventory: Runs observe and analyze passes (hardening scan, services, security tooling, logs, capacity) and journals every finding in a SQLite database with stable fingerprints so re-runs never duplicate. - Report and status: Produces plain-language summaries of the journal state and the last run for technical and non-technical readers. - Monitor and fix: Watches a single concern live (e.g. CORS preflight 403s in Apache logs) announcing only new deltas, and remediates findings through risk-tiered fix flows where destructive actions always stop, warn, and ask. - Stats: Generates GDPR-friendly web traffic analytics from existing access logs with IPs correlated in memory only. - Use Case: An operator runs /watchman audit on a Debian web server, reviews the prioritized findings, then launches watchman fix from the shell to apply safe-tier remediations with per-change confirmation. ## Quick Start Ask the assistant to run /watchman audit to scan this machine and journal all security and capacity findings. ## Quick Start Run /watchman audit in a Claude Code session from the claude-watchman repo root to scan the machine and journal findings.

Frequently Asked Questions about watchman

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a security audit on my Linux server with Claude Code?▼

Run /watchman audit in a Claude Code session from the claude-watchman repo root. It executes the observe and analyze skills (hardening scan, services, logs, capacity) and journals every finding through lib/journal.sh without applying any fixes.

How do I monitor a log file for new errors in real time?▼

Use /watchman monitor with a freeform focus, such as watching the Apache error log for CORS preflight 403s, under Claude Code's /loop for recurrence. Each pass announces only lines new since the previous pass using offset or snapshot helpers.

Can watchman apply fixes automatically without confirmation?▼

No. The Prime Directive requires stopping, warning, and asking before any destructive action, and fixes run only in a watchman fix session where safe-tier changes are pre-approved and review-tier changes prompt per change. The unattended loop physically cannot reach a destructive step.

Does watchman support macOS and different Linux distributions?▼

Yes. It runs on Debian/Ubuntu, RHEL-family, Arch, and macOS, adapting to whether the machine is a public server or a personal workstation and using the platform's own integrity verifier and defensive tooling.

Why are my fix commands being denied in a watchman session?▼

You are in the default read-only profile where every mutating command auto-denies. Exit Claude and relaunch with watchman fix from the shell, which opens a session bound to the FIX profile with mutating permissions.

How does watchman web analytics work without trackers?▼

The stats verb builds a traffic report from the server's existing access logs, covering page views, unique visitors, top pages, referrers, and bots versus humans. IPs are correlated in memory only and never stored, making it GDPR-friendly.