uatu 0.1.0

The Watcher - An agentic system troubleshooting tool powered by Claude

Uatu - The Watcher

An agentic system troubleshooting tool powered by Claude. Chat with your system, investigate issues with AI-powered analysis, and autonomously monitor for anomalies.

Why Uatu?

Traditional monitoring tools alert you to problems. Uatu understands them.

Core capabilities:

• Interactive chat mode for conversational system troubleshooting
• One-shot investigations for specific symptoms
• Continuous monitoring with adaptive baseline learning
• Root cause analysis connecting CPU, memory, processes, and logs
• Token-efficient caching and rate limiting for cost control

Installation

# Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install dependencies
uv sync

# Configure API key
echo "ANTHROPIC_API_KEY=your_key" > .env

Quick Start

Interactive Chat Mode (Default)

Start a conversational troubleshooting session:

uv run uatu

Ask questions naturally and get AI-powered analysis:

• "What's causing high CPU usage?"
• "Why is my server running slowly?"
• "Investigate recent memory issues"
• "Check for network bottlenecks"

One-Shot Investigation

Investigate a specific symptom immediately:

uv run uatu investigate "server running slowly"
uv run uatu investigate "high CPU usage"
uv run uatu investigate "memory leak suspected"

The agent will:

• Gather relevant system information
• Analyze logs and metrics
• Provide root cause analysis
• Suggest actionable remediation steps

Continuous Monitoring

Watch your system and detect anomalies autonomously:

# Fast testing (1 minute baseline)
uv run uatu watch --baseline 1

# Production monitoring (5 minute baseline, default)
uv run uatu watch

# With AI investigation of detected anomalies
uv run uatu watch --investigate

Configuration

Create .env with options:

# Required
ANTHROPIC_API_KEY=your_key

# Optional
UATU_MODEL=claude-sonnet-4-5-20250929  # Claude model to use
UATU_READ_ONLY=true                     # Agent can only read, not modify system
UATU_REQUIRE_APPROVAL=true              # Require approval for risky actions

Development

# Run tests (20 unit tests)
uv run pytest

# Lint
uv run ruff check .

# Format
uv run ruff format .

License

This project is licensed under the MIT License - see the LICENSE file for details.