Skip to content

ai-monitor

Proactive system monitoring daemon with anomaly detection and suggestions

Version: 9.0.1 | Size: 2.6MB | Author: Warith Al Maawali

License: Proprietary | Website: https://www.digi77.com


File Information

Property Value
Binary Name ai-monitor
Version 9.0.1
Build Date 2026-02-14T07:59:32.807442993Z
Rust Version 1.82.0
File Size 2.6MB
JSON Data View Raw JSON

SHA256 Checksum

1f8ec9f35a02304a92c7fad3427eabcd72333b2293f2f1574328f8a47603eca1

Features

Feature Description
Core Advanced functionality for Kodachi OS

Security Features

Feature Description
Inputvalidation All inputs are validated and sanitized
Ratelimiting Built-in rate limiting for network operations
Authentication Secure authentication with certificate pinning
Encryption TLS 1.3 for all network communications

System Requirements

Requirement Value
OS Linux (Debian-based)
Privileges root/sudo for system operations
Dependencies OpenSSL, libcurl

Global Options

Flag Description
-h, --help Print help information
-v, --version Print version information
-n, --info Display detailed information
-e, --examples Show usage examples
--json Output in JSON format
--json-pretty Pretty-print JSON output with indentation
--json-human Enhanced JSON output with improved formatting (like jq)
--verbose Enable verbose output
--quiet Suppress non-essential output
--no-color Disable colored output
--config <FILE> Use custom configuration file
--timeout <SECS> Set timeout (default: 30)
--retry <COUNT> Retry attempts (default: 3)

Commands

Commands

start

Start the system monitoring daemon

Usage:

ai-monitor ai-monitor start [OPTIONS]

Options: - --interval: Check interval in seconds - --threshold: Security score threshold - --daemon: Run as background daemon

Examples:

ai-monitor start
ai-monitor start --interval 60
ai-monitor start --threshold 80
ai-monitor start --daemon

status

Show current monitor status and statistics

Usage:

ai-monitor ai-monitor status

Options: - --verbose: Show detailed status

Examples:

ai-monitor status
ai-monitor status --verbose
ai-monitor status --json

suggestions

List and manage proactive suggestions

Usage:

ai-monitor ai-monitor suggestions [OPTIONS]

Options: - --category: Filter by category - --resolve: Resolve suggestion by ID - --dismiss: Dismiss suggestion by ID - --cleanup: Cleanup old suggestions

Examples:

ai-monitor suggestions
ai-monitor suggestions --category security
ai-monitor suggestions --resolve 1
ai-monitor suggestions --dismiss 2
ai-monitor suggestions --cleanup
ai-monitor suggestions --json

service

Manage the ai-monitor systemd service lifecycle

Usage:

ai-monitor ai-monitor service <ACTION>

Options: - <ACTION>: install | uninstall | enable | disable | status

Examples:

sudo ai-monitor service install
sudo ai-monitor service enable
ai-monitor service status
sudo ai-monitor service disable
sudo ai-monitor service uninstall

Examples

Basic Usage

Basic monitoring operations

Start the monitoring daemon with default settings

ai-monitor start
Expected Output: Monitor daemon started successfully

Show current monitor status

ai-monitor status
Expected Output: Monitor status with active suggestions count

List all active suggestions

ai-monitor suggestions
Expected Output: List of proactive suggestions

Start daemon with JSON status output

ai-monitor start --json
Expected Output: JSON response with daemon process info

Note

Useful for automated service management

Get monitor status as JSON

ai-monitor status --json
Expected Output: JSON with monitor state and suggestion counts

Note

Structured output for monitoring dashboards

List all suggestions as JSON

ai-monitor suggestions --json
Expected Output: JSON array of active suggestions with metadata

Note

Structured output for programmatic consumption

Advanced Configuration

Advanced monitoring and suggestion management

Start with custom interval and security threshold

ai-monitor start --interval 60 --threshold 80
Expected Output: Monitor started with custom configuration

Note

Interval in seconds, threshold 1-100

Start monitor as background daemon

ai-monitor start --daemon
Expected Output: Monitor daemon started in background

List security-related suggestions only

ai-monitor suggestions --category security
Expected Output: Filtered suggestions by category

Show network-related suggestions

ai-monitor suggestions --category network
Expected Output: Network category suggestions

Mark suggestion as resolved

ai-monitor suggestions --resolve 1
Expected Output: Suggestion marked as resolved

Get detailed status in JSON format

ai-monitor status --verbose --json
Expected Output: Comprehensive monitor status in JSON

Start with all parameters and JSON output

ai-monitor start --interval 60 --threshold 80 --json
Expected Output: JSON with custom interval and threshold configuration

Note

60-second interval, 80% security threshold, structured output

Security suggestions as JSON

ai-monitor suggestions --category security --json
Expected Output: JSON array of security-category suggestions

Note

Filter and format combined for automation

Service Management

Manage the systemd daemon lifecycle

Install service (if needed) and start as systemd daemon

sudo ai-monitor start --daemon
Expected Output: ai-monitor daemon started via systemd

Note

Requires root. Auto-installs the service file.

Install the systemd service file

sudo ai-monitor service install
Expected Output: Service installed successfully

Check the daemon status

ai-monitor service status
Expected Output: Service status with active/enabled state

Note

Does not require root

Check daemon status as JSON

ai-monitor service status --json
Expected Output: JSON with service active/enabled state

Note

Structured output for monitoring scripts

Stop, disable, and remove the service

sudo ai-monitor service uninstall
Expected Output: Service uninstalled successfully

AI Tier Health Monitoring

Monitor health status of all 6 AI engine tiers

Show health status of all AI tiers

ai-monitor status --json
Expected Output: JSON with per-tier availability and health

Note

Covers TF-IDF, ONNX, Mistral.rs, GenAI/Ollama, Legacy LLM, Claude tiers

Security suggestions including AI tier recommendations

ai-monitor suggestions --category security --json
Expected Output: JSON with AI-informed security suggestions

Note

AI tiers can generate security recommendations via tool calling

Monitor with AI tier health checks every 2 minutes

ai-monitor start --interval 120 --json
Expected Output: Daemon started with AI tier monitoring enabled

Note

Periodically checks Ollama, GGUF model, and Claude CLI availability

Maintenance Operations

Cleanup and maintenance commands

Cleanup old inactive suggestions

ai-monitor suggestions --cleanup
Expected Output: Count of cleaned up suggestions

Note

Removes suggestions older than 30 days

Dismiss a suggestion without resolving

ai-monitor suggestions --dismiss 2
Expected Output: Suggestion marked as dismissed

Show optimization suggestions

ai-monitor suggestions --category optimization
Expected Output: Performance and optimization suggestions

Show recovery suggestions

ai-monitor suggestions --category recovery
Expected Output: System recovery and repair suggestions

ONNX Classifier & Policy Monitoring

Monitor ONNX intent classifier and AI policy file health

Check ONNX intent classifier health

ai-monitor status --json
Expected Output: JSON including ONNX classifier model status

Note

Verifies kodachi-intent-classifier.onnx is loadable

Check AI policy file integrity

ai-monitor status --json
Expected Output: JSON including policy file signature verification

Note

Verifies ai-policy.json exists and signature is valid

Show ONNX vs LLM routing statistics

ai-monitor status --json
Expected Output: JSON with fast-path (ONNX) vs slow-path (LLM) breakdown

Note

Shows percentage of queries routed via fast path

Environment Variables

Variable Description Default Values
RUST_LOG Set logging level info error
NO_COLOR Disable all colored output when set unset 1

Exit Codes

Code Description
3 Permission denied
4 Network error
2 Invalid arguments
0 Success
5 File not found
1 General error