Binary reference

ai-discovery

Kodachi Auto-Discovery Daemon - Monitors and indexes Rust service binaries

Version9.8.4Size1.6MBAuthorWarith Al MaawaliLicenseProprietaryWebsitehttps://www.digi77.com

File Information

Property	Value
Binary Name	ai-discovery
Version	9.8.4
Build Date	Not disclosed
Rust Version	1.82.0
File Size	1.6MB
Author	Warith Al Maawali
License	Proprietary
Category	Kodachi Binary
Description	Kodachi Auto-Discovery Daemon - Monitors and indexes Rust service binaries
Git Commit	unknown
Metadata Generated	2026-07-11T18:16:15Z
Binary Timestamp	Unknown
JSON Data	View Raw JSON

SHA256 Checksum

2bf424283eea586556de0cb384f399280a3efbc5d9007764b91f6f89061fccf6

Features

#	Feature
1	Binary file watching with inotify
2	Automatic command extraction from -e --json
3	Live command registry updates
4	Daemon process management

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

Daemon Control

`start`

Start the auto-discovery daemon

Usage:

ai-discovery start [OPTIONS]

`status`

Show daemon status

Usage:

ai-discovery status [OPTIONS]

Registry Management

`reindex`

Force reindex all binaries

Usage:

ai-discovery reindex [OPTIONS]

Operational Scenarios

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

Scenario 1: Daemon Control

Start and monitor the auto-discovery daemon

Step 1: Start discovery daemon to monitor binaries

sudo ai-discovery start

Expected Output: Discovery daemon started successfully

Note

Monitors /dashboard/hooks/rust/*/target/release/

Step 2: Start in foreground mode for debugging

sudo ai-discovery start --foreground

Expected Output: Discovery daemon running in foreground

Note

Shows real-time file system events

Step 3: Foreground mode with JSON status output

sudo ai-discovery start --foreground --json

Expected Output: JSON events as binaries are discovered

Note

Combines debug visibility with structured output

Step 4: Check daemon status and registry statistics

ai-discovery status

Expected Output: Daemon status with command registry info

Note

Shows total commands, services, and last update

Step 5: Get status in JSON format

ai-discovery status --json

Expected Output: JSON response with daemon and registry status

Note

Useful for automated monitoring scripts

Scenario 2: Registry Management

Manage the command registry and reindex binaries

Step 1: Force reindex all Rust service binaries

sudo ai-discovery reindex

Expected Output: All binaries reindexed successfully

Note

Extracts commands using -e --json from each binary

Step 2: Reindex with JSON output

sudo ai-discovery reindex --json

Expected Output: Reindex results in JSON format

Note

Shows discovered services and command counts

Step 3: Reindex specific service only

ai-discovery reindex --service health-control

Expected Output: Single service reindexed successfully

Note

Faster than full reindex for debugging

Step 4: Reindex single service with JSON output

ai-discovery reindex --service health-control --json

Expected Output: JSON with reindexed command count for health-control

Note

Fast targeted reindex with structured output

Step 5: Show detailed registry contents

ai-discovery status --verbose

Expected Output: Full list of discovered commands by service

Note

Displays all registered commands and metadata

Step 6: Detailed registry contents as JSON

ai-discovery status --verbose --json

Expected Output: JSON with full command list by service

Note

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