Binary reference

ai-admin

AI system administration and maintenance

Version9.8.4Size3.9MBAuthorWarith Al Maawali <warith@digi77.com>LicenseProprietaryWebsitehttps://www.digi77.com

File Information

Property	Value
Binary Name	ai-admin
Version	9.8.4
Build Date	Not disclosed
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-07-11T18:16:16Z
Binary Timestamp	Unknown
JSON Data	View Raw JSON

SHA256 Checksum

5c7cbc7f7d8b4f38702b502fddb7b6f6e8b75167457421333026ba6ac034cd75

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

`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 7-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
4	Network error
0	Success
5	File not found
2	Invalid arguments
1	General error
3	Permission denied