Infrastructure Tools

OPERATIONS HUB

The plumbing behind Kodachi: workflows, logs, dependency checks, launchers, status, and online information.

Use this area when you are operating or troubleshooting the stack: run workflows, inspect logs, validate dependencies, and monitor system status.

Workflows Logs Dependencies Status

Service Infrastructure Backbone

Infrastructure binaries provide the operational foundation for Kodachi services: centralized logs, dependency validation, global deployment, workflow orchestration, and controlled online intelligence feeds.

6 Core Binaries 53 Commands Centralized Logging Deployment Automation Workflow Engine

Platform Operations

Ops

logs-hook, deps-checker, and global-launcher deliver system-wide observability, package readiness checks, and consistent binary deployment across installations.

17 Core Ops Commands System-Wide Scope Fast Deployment

Workflow and Information Layer

Flow

workflow-manager, online-info-switch, and conky-status add conditional automation, feed aggregation, and unified desktop telemetry with authentication-aware controls.

36 Automation Commands Conditional Logic JSONL Telemetry

Documentation Navigation

Navigate the documentation:

Enterprise-Grade Service Infrastructure and Management

The infrastructure tools in Kodachi OS provide the foundational service layer for logging, dependency management, service deployment, and information control. These production-ready binaries ensure reliable system operation through centralized logging, automated deployment, and comprehensive dependency validation.

Core Architecture Principles - Verified

Centralized Management: Single point of control for logs, dependencies, and deployments

Zero Configuration: Embedded configurations with no external YAML dependencies

Service Orchestration: Automated deployment and verification of all binaries

Information Control: Secure management of online exposure and data feeds

Binary Categories and Requirements

Core Infrastructure Tools

Binary Primary Function Commands Requires Auth Requires Sudo Auto-Start
logs-hook Centralized secure logging infrastructure 7 No Yes (system logs) Auto-integrated
deps-checker Dependency validation and security auditing 6 No Yes (install) No
global-launcher System-wide binary deployment manager 4 No Yes (global) Called by online-auth
workflow-manager Batch command execution with conditional logic 18 Yes (11%) Yes (system ops) No
online-info-switch Online information hub and RSS feeds 11 Yes Yes (system ops) No
conky-status Unified Conky desktop telemetry gateway 4 No No Auto (desktop watchdog)

Inter-Binary Dependencies Matrix

Binary Communication Flow

Service Calls These Binaries Called By These Binaries
logs-hook None ALL binaries (auto-integrated in all services)
deps-checker logs-hook None
global-launcher logs-hook online-auth
workflow-manager logs-hook None (user-initiated)
online-info-switch logs-hook, online-auth, health-control None
conky-status logs-hook, online-auth, ip-fetch, health-control, dns-switch Desktop Conky panels and scripts

Critical Service Dependencies

Dependency Type Description Affected Services
Logging Integration All services automatically integrate logs-hook ALL Kodachi binaries
Deployment Chain Services deployed by global-launcher All Rust binaries
Authentication Services requiring online-auth online-info-switch
System Health Services using health-control online-info-switch

System Requirements and Permissions

Privilege Escalation Requirements

Operation Type Required Permissions Affected Binaries
System Logging sudo/root logs-hook (system-wide logs)
Package Installation sudo/root deps-checker (apt-get operations)
Global Deployment sudo/root global-launcher (/opt/kodachi/dashboard/hooks/global-launcher)
System Operations sudo/root online-info-switch (network checks)

Service Integration Levels

Integration Level Method Services
Embedded Compiled into binary logs-hook in all services
System-wide Global symlinks global-launcher deployments
Package Manager APT/dpkg integration deps-checker
Network APIs HTTPS with cert pinning online-info-switch

Key Capabilities Overview

Workflow Management (workflow-manager - 18 commands)

Feature Description
Template Creation Create reusable workflow templates
Batch Execution Execute multiple commands sequentially
Conditional Logic Hybrid conditions: success/fail + pattern matching + JSON path
Pause Steps Interactive pause points with user confirmation
State Tracking Maintain workflow execution state
Telemetry Logging Comprehensive execution logs in JSONL format
Retry Logic Built-in retry mechanisms for failed steps
Timeout Control Configurable timeouts per step
Dry Run Mode Test workflows without execution

Centralized Logging (logs-hook - 7 commands)

Feature Description
Log Levels Multiple levels: info, warn, error, debug, fatal
Script Categorization Script-based log categorization
JSON Output JSON format for automation
Log Rotation Automatic rotation with size limits
Secure Wiping Secure wiping with verification
Selective Operations Selective file operations
Auto-embedded Embedded in all binaries
Centralized Storage /opt/kodachi/dashboard/hooks/logs/ directory
Structured Format Consistent logging format

Dependency Management (deps-checker - 6 commands)

Feature Description
Single Binary Check Dependency checking for individual binaries
System-wide Audit Complete dependency audit across system
Profile-based Checking Minimal/full profile options
Auto Installation Automatic missing package installation
Script Generation Generate install scripts for multiple shells
SBOM Generation Software Bill of Materials generation
Database Support External dependency database
Version Tracking Track dependency versions
Security Audit Integration with security auditing

Binary Deployment (global-launcher - 4 commands)

Feature Description
Dynamic Discovery Automatic binary discovery
Global Symlinks Create symlinks in /usr/local/bin
Multi-language Support Support for Rust binaries
Status Checking Deployment status verification
Integrity Verification Symlink integrity checks
Rollback Rollback capabilities
Folder Containment Execution folder containment
Permission Preservation Maintain file permissions
Atomic Operations Ensure operation atomicity

Information Hub (online-info-switch - 11 commands)

Feature Description
Status Detection Online/offline status detection
RSS Feeds Security RSS feed aggregation
Paste Services Public paste service integration
Proof of Freshness News + blockchain verification
Crypto Prices Cryptocurrency price monitoring
Wallet Balance Bitcoin wallet balance checking
Certificate Pinning Secure connections with cert pinning
Auth Verification Authentication verification
Rate Limiting Protection against excessive requests

Common Workflows

Workflow Management

# Create workflow template
workflow-manager create my-workflow

# Add commands (comma-separated for multiple)
workflow-manager add my-workflow "sudo ip-fetch","sudo online-auth check-login"

# Run workflow
sudo workflow-manager run my-workflow

# Test without execution
sudo workflow-manager run my-workflow --dry-run

# List all workflows
workflow-manager list

Logging Operations

# Log a message with specific level
logs-hook log --script "deployment" --level info "Service started"

# Rotate logs when they get large
sudo logs-hook maintenance rotate --file system.log

# Secure wipe of old logs
sudo logs-hook maintenance wipe --all

Dependency Management

# Check dependencies for specific binary
deps-checker check health-control

# System-wide dependency audit
sudo deps-checker check-all --profile full

# Install missing dependencies
sudo deps-checker install-missing

# Generate installation script
deps-checker generate-script --shell bash > install_deps.sh

Service Deployment

# Deploy all binaries globally
cd /opt/kodachi/dashboard/hooks && sudo ./global-launcher deploy

# Verify deployment status
cd /opt/kodachi/dashboard/hooks && ./global-launcher verify

# Clean up deployments
cd /opt/kodachi/dashboard/hooks && sudo ./global-launcher cleanup

Information Services

# Check online status
online-info-switch status --json

# Get security RSS feeds
online-info-switch rss --max-items 10

# Proof of freshness
online-info-switch freshness --json

# Cryptocurrency prices
online-info-switch price all

Performance Metrics

Metric Value Description
Total Commands 53 Across infrastructure binaries
Log Processing 10,000 lines/sec Maximum throughput
Deployment Time < 5 seconds For all binaries
Dependency Check < 2 seconds Per binary
Memory Usage < 50MB Combined services

Infrastructure Architecture

Logging Architecture

Application → logs-hook (embedded) → Centralized Logs
                ↓
        Log Rotation/Wiping
                ↓
        Archive/Destruction

Dependency Flow

Binary Request → deps-checker → Package Database
                     ↓
            Validation/Installation
                     ↓
              System Packages

Deployment Pipeline

Source Binaries → global-launcher → Discovery
                        ↓
                Symlink Creation
                        ↓
                 /usr/local/bin/

Service Management

Auto-Integration Features

Feature Implementation Services
Logging Compile-time embedding All binaries
Authentication Runtime verification online-info-switch
Deployment System-wide symlinks All services
Dependencies Package manager integration System-wide

Maintenance Operations

# Daily maintenance routine
sudo logs-hook maintenance rotate
sudo deps-checker check-all
cd /opt/kodachi/dashboard/hooks && ./global-launcher verify

# Weekly maintenance
sudo logs-hook maintenance wipe --all
sudo deps-checker install-missing

Integration Points

The infrastructure tools integrate with:

Integration Type Components/Description
All Kodachi Binaries Through embedded logs-hook
Package Managers APT, dpkg for dependencies
File System /usr/local/bin for deployments
Network Services RSS feeds, APIs, paste services
Authentication online-auth for secure operations

Troubleshooting

Common Issues

Issue Solution Prevention
Logs not rotating Check disk space, permissions Monitor log sizes
Dependencies missing Run install-missing Regular audits
Deployment fails Check sudo permissions Verify before deploy
RSS feeds empty Check network, authentication Test connectivity

Diagnostic Commands

# Check logging system
logs-hook log --script test --level debug "Test message"

# Verify dependencies
deps-checker check-all --verbose

# Test deployment
cd /opt/kodachi/dashboard/hooks && sudo ./global-launcher deploy

# Check online services
online-info-switch status --verbose

Security Considerations

Important Security Notice

Infrastructure tools have system-wide impact. Always verify operations before execution, especially deployment and package installation commands.

Security Features

Feature Description
Embedded Configurations No external config files to tamper
Execution Containment Services operate within bounds
Certificate Pinning Secure network connections
Audit Trails Complete logging of operations
Permission Preservation Maintain security boundaries

Best Practices

Practice Description
Regular Audits Check dependencies weekly
Log Management Rotate and archive logs
Deployment Verification Always verify after deploy
Network Security Use authentication for online services
Backup Strategy Maintain deployment rollback capability

Advanced Features

Log Analysis

# Search logs for errors
grep -i error /opt/kodachi/dashboard/hooks/logs/*.log

# JSON log parsing
logs-hook log --json | jq '.level == "error"'

# Real-time monitoring
tail -f /opt/kodachi/dashboard/hooks/logs/system.log

Dependency Profiles

Profile Use Case Packages
Minimal Core functionality Essential only
Full Complete feature set All dependencies
Security Security tools Audit and monitoring
Development Dev environment Build tools included

Deployment Strategies

Strategy Description Use Case
Full Deploy All binaries Initial setup
Selective Specific services Updates
Rollback Previous state Recovery
Verify Only Check without change Audit

System Information

Component Version Build Date License
logs-hook 9.0.1 2026-06-28 Proprietary
deps-checker 9.0.1 2026-03-05 MIT
global-launcher 9.0.1 2026-06-28 Proprietary
workflow-manager 9.0.1 2026-06-28 Proprietary
online-info-switch 9.0.1 2026-06-28 Proprietary
Documentation 9.0.1 2026-06-28 © 2026 Linux Kodachi