global-launcher

Global launcher for Kodachi dashboard binaries with execution folder containment

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

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

File Information

Property	Value
Binary Name	global-launcher
Version	9.0.1
Build Date	2025-10-21T20:27:12.359506263Z
Rust Version	rustc 1.88.0 (6b00bc388 2025-06-23)
File Size	1.4MB
JSON Data	View Raw JSON

SHA256 Checksum

391ac2559a1f9d2c94a70f490c93fac1db96324c25ac7a0096291a1c9fb60d82

Features

Feature	Description
Feature	Dynamic binary discovery and deployment
Feature	Execution folder containment for security
Feature	Symlink-based global access
Feature	Comprehensive error handling and logging
Feature	Support for both Rust and Gambas binaries
Feature	Deployment verification and rollback
Feature	JSON and text output formats
Feature	Zero hardcoded paths - fully dynamic

Security Features

Feature	Description
Authentication	Integrates with system permissions and user context
Encryption	Secure configuration embedded in binary
Inputvalidation	All binary names and paths are validated against security rules
Ratelimiting	Configurable timeouts prevent resource exhaustion

System Requirements

Requirement	Value
OS	Linux (Debian-based, specifically Kodachi OS)
Privileges	root/sudo for global deployment
Dependencies	cli-core library, logs-hook service, symlink support in filesystem

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
`--verbose`	Enable verbose output
`--quiet`	Suppress non-essential output
`--no-color`	Disable colored output
`--timeout <SECS>`	Set timeout (default: 600)
`--user-override <USERNAME>`	Override target user for deployment
`--json-report`	Save operation results to JSON file in results directory

Commands

Management Commands

`deploy`

Deploy global symlinks for all dashboard binaries

Usage:

global-launcher deploy [OPTIONS]

Options: - --force: Force deployment even if binaries exist - --no-verify: Skip verification after deployment

Examples:

sudo ./global-launcher deploy

sudo ./global-launcher deploy --json

sudo ./global-launcher deploy --force

`verify`

Verify deployed symlinks are working

Usage:

global-launcher verify [OPTIONS]

Options: - --detailed: Show detailed verification info

Examples:

./global-launcher verify

./global-launcher verify --json

./global-launcher verify --detailed

`cleanup`

Remove all deployed symlinks

Usage:

global-launcher cleanup [OPTIONS]

Options: - --yes: Confirm cleanup without prompting

Examples:

sudo ./global-launcher cleanup

sudo ./global-launcher cleanup --yes

sudo ./global-launcher cleanup --json

Examples

Deployment Operations

Deploying and managing global binary access

Deploy global access for all dashboard binaries

sudo ./global-launcher deploy

Expected Output: Creates symlinks in /usr/local/bin for all discovered binaries

Note

Requires sudo for writing to /usr/local/bin

Deploy with JSON terminal output

sudo ./global-launcher deploy --json

Expected Output: JSON response with deployment results and statistics on terminal

Deploy and save audit file to results directory

sudo ./global-launcher deploy --json-report

Expected Output: Creates deployment report as JSON file in hooks/results/

Note

Automatically cleans up old report files

Force deployment, replacing existing symlinks

sudo ./global-launcher deploy --force

Expected Output: Overwrites existing symlinks and creates backups

Verification Operations

Verifying deployed symlinks work correctly

Verify all deployed symlinks

./global-launcher verify

Expected Output: Reports on symlink status and any issues found

Verify and save report to results directory

./global-launcher verify --json-report

Expected Output: Creates verification report as JSON file in hooks/results/

Detailed verification with JSON terminal output

./global-launcher verify --detailed --json

Expected Output: Comprehensive JSON report of verification results on terminal

Using Global Binaries

Once deployed, binaries work from anywhere

Run health-control from any directory

health-control status

Expected Output: Executes health-control in hooks directory context

Note

Works from any location after deployment

Run ip-fetch with JSON output globally

ip-fetch --json

Expected Output: IP information in JSON format

List DNS servers from anywhere

dns-switch list

Expected Output: DNS server list with current configuration

Cleanup Operations

Removing global binary access

Remove all deployed symlinks

sudo ./global-launcher cleanup

Expected Output: Removes all symlinks and reports count

Note

Requires sudo for removing from /usr/local/bin

Auto-confirm cleanup with JSON terminal output

sudo ./global-launcher cleanup --yes --json

Expected Output: JSON response with cleanup results on terminal

Cleanup and save report to results directory

sudo ./global-launcher cleanup --json-report

Expected Output: Creates cleanup report as JSON file in hooks/results/

Environment Variables

Variable	Description	Default	Values
`RUST_LOG`	Set logging level	info	error
`NO_COLOR`	Disable colored output when set	unset	1
`KODACHI_BASE_DIR`	Override hooks directory location	auto-detected	/path/to/hooks

Exit Codes

Code	Description
0	Success
1	General error
10	Security violation
2	Invalid arguments
3	Permission denied
4	Binary not found
5	Directory not found
6	Timeout
7	Deployment error
8	Execution error
9	Validation error