ai-admin

AI system administration and maintenance

Version: 9.8.4 | Size: 3.9MB | Author: Warith Al Maawali <warith@digi77.com>

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

File Information

Property Value
Binary Name ai-admin
Version 9.8.4
Build Date REDACTED-BUILD-TIME
Rust Version 1.82.0
File Size 3.9MB
Author Warith Al Maawali <warith@digi77.com>
License Proprietary
Category Kodachi Binary
Description AI system administration and maintenance
Git Commit unknown
Metadata Generated 2026-06-28T11:16:26Z
Binary Timestamp Unknown
JSON Data View Raw JSON

SHA256 Checksum

62b1961ea3cc086f3c429d446db5d94f9dbca82997eed3d234b0c1c2e47affd2

Features

# Feature
1 Advanced functionality for Kodachi OS

Security Features

Feature Description
Input Validation Argument parsing via clap; per-command validation is the consumer's responsibility
Rate Limiting Not provided by cli-core
Authentication Not provided by cli-core (see online-auth)
Encryption Not provided by cli-core

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
-o, --output-format <FORMAT> Force output format (text|json)
--json-pretty Pretty-print JSON output with indentation
--json-human Enhanced JSON output with improved formatting (like jq)
--fields <FIELD_LIST> Select specific fields to include in output (comma-separated)
--limit <NUMBER> Limit number of results returned
--offset <NUMBER> Skip first N results (for pagination)
-d, --work-dir <PATH> Working directory (defaults to auto-detected base directory)
--port <PORT> Set custom port number (1024-65535)
--log-level <LEVEL> Set log level (error|warn|info|debug)
--verbose Enable verbose output
--quiet Suppress non-essential output
--no-color Disable colored output
--config <FILE> Use custom configuration file
--timeout <SECS> Set operation timeout in seconds (optional; no default applied)
--retry <COUNT> Retry attempts (optional; no default applied)

Commands

Commands

db

Database management operations

Usage: 

ai-admin db [OPTIONS]

diagnostics

Run system diagnostics

Usage: 

ai-admin diagnostics [OPTIONS]

tune

Performance tuning and optimization

Usage: 

ai-admin tune [OPTIONS]

Operational Scenarios

Scenario-oriented workflows generated from the binary's built-in -e --json examples.

Scenario 1: Database Operations

Database backup, restore, and management

Step 1: Create database backup

ai-admin db backup --output ./backup.db
Expected Output: Backup created successfully

Note

Backup file will be created in execution folder

Step 2: Restore database from backup

ai-admin db restore --backup ./backup.db
Expected Output: Database restored successfully

Note

Current database will be backed up before restore

Step 3: Check database integrity

ai-admin db integrity-check
Expected Output: Database integrity check results

Step 4: Run database migrations

ai-admin db migrate
Expected Output: Migrations applied successfully

Step 5: Show database information and statistics

ai-admin db info
Expected Output: Database size, table counts, and statistics

Note

Useful for monitoring database growth

Step 6: Show database info as JSON

ai-admin db info --json
Expected Output: Database information in JSON format

Note

Useful for automated monitoring

Scenario 2: System Diagnostics

System health checks and diagnostics

Step 1: Run basic diagnostics

ai-admin diagnostics
Expected Output: System diagnostics report

Step 2: Run full diagnostics including integrity checks

ai-admin diagnostics --full
Expected Output: Comprehensive diagnostics report

Note

Includes database integrity and model validation

Step 3: Full diagnostics with JSON output

ai-admin diagnostics --full --json
Expected Output: Comprehensive diagnostics in JSON format

Note

Full diagnostics include integrity checks

Step 4: Run diagnostics with JSON output

ai-admin diagnostics --json
Expected Output: Basic diagnostics in JSON format

Note

Useful for automated health monitoring

Scenario 3: AI Tier Configuration

Administration of the 6-tier AI engine system

Step 1: Full diagnostics including all AI tier health

ai-admin diagnostics --full --json
Expected Output: JSON with tier availability, model paths, and health status

Note

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

Step 2: Quick diagnostics with AI tier status summary

ai-admin diagnostics --json
Expected Output: JSON with basic tier configuration info

Note

Faster than --full, covers essential tier checks

Scenario 4: Performance Tuning

Database optimization and performance tuning

Step 1: Optimize database performance

ai-admin tune optimize
Expected Output: Database optimized successfully

Note

Runs VACUUM and ANALYZE operations

Step 2: Rebuild database indexes

ai-admin tune rebuild-index
Expected Output: Indexes rebuilt successfully

Step 3: Clean up old data (older than 30 days)

ai-admin tune cleanup --days 30
Expected Output: Cleanup completed, X records removed

Step 4: Clean up data older than 7 days

ai-admin tune cleanup --days 7
Expected Output: Cleanup completed, X records removed

Note

More aggressive cleanup for recent data

Step 5: Optimize database with JSON output

ai-admin tune optimize --json
Expected Output: Optimization results in JSON format

Note

Shows detailed optimization statistics

Step 6: Rebuild indexes with JSON output

ai-admin tune rebuild-index --json
Expected Output: Index rebuild results in JSON format

Note

Structured output for automation pipelines

Step 7: Aggressive cleanup with JSON output

ai-admin tune cleanup --days 7 --json
Expected Output: JSON with cleanup statistics and records removed

Note

Combines short retention with structured output

Environment Variables

Variable Description Default Values
RUST_LOG Set logging level info error|warn|info|debug|trace
NO_COLOR Disable all colored output when set unset 1|true|yes (any value disables color)

Exit Codes

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