Binary reference

kodachi-session-helper

Global emergency keyboard shortcut daemon for Kodachi OS

Version9.8.4 (build 320)Size2.3MBAuthorWarith Al MaawaliLicenseProprietaryWebsitehttps://digi77.com

File Information

Property	Value
Binary Name	kodachi-session-helper
Version	9.8.4 (build 320)
Build Date	Not disclosed
Rust Version	1.82.0
File Size	2.3MB
Author	Warith Al Maawali
License	Proprietary
Category	Kodachi Binary
Description	Global emergency keyboard shortcut daemon for Kodachi OS
Git Commit	unknown
Metadata Generated	2026-07-11T18:16:34Z
Binary Timestamp	Unknown
JSON Data	View Raw JSON

SHA256 Checksum

e845d194c0622db5ad3ee5dc3800d4fd05327ca60ca5348f16c86974a2044767

Features

#	Feature
1	X11 key grab registration with collision detection
2	Raw /dev/input hardware corroboration (anti-XTEST)
3	Hold-to-trigger with auto-repeat rejection (1500ms default)
4	Local session token authentication (no network required)
5	Delayed lockdown with cancel capability
6	Unix socket for dashboard status queries
7	Atomic config reload via SIGHUP
8	LUKS device wipe + dashboard nuke combined actions
9	X11 disconnect detection with auto-reconnect
10	Memory protection via mlock and PR_SET_DUMPABLE

Security Features

Feature	Description
Authentication	Local 256-bit session token (no network dependency)
Encryption	SHA-256 token digest; memory locked and zeroized on exit
Input Validation	All configuration validated; key grabs verified against collisions
Rate Limiting	Hold-to-trigger with cooldown prevents accidental re-trigger

System Requirements

Requirement	Value
OS	Linux (Kodachi OS / Debian-based with X11)
Privileges	User session (non-root); 'input' group for evdev
Dependencies	X11 display server, health-control binary, /dev/input access (input group)

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
`--json-human`	Enhanced JSON output (like jq)
`--verbose`	Enable verbose output
`--quiet`	Suppress non-essential output

Commands

Daemon Control

`daemon`

Start the emergency shortcut daemon

Usage:

kodachi-session-helper daemon

Examples:

kodachi-session-helper daemon

`status`

Query the running daemon's status

Usage:

kodachi-session-helper status [--json]

Examples:

kodachi-session-helper status

kodachi-session-helper status --json

`reload`

Send SIGHUP to reload configuration

Usage:

kodachi-session-helper reload

Examples:

kodachi-session-helper reload

Operational Scenarios

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

Scenario 1: Daemon Control

Starting, stopping, and managing the daemon

Step 1: Start the emergency shortcut daemon

kodachi-session-helper daemon

Expected Output: Daemon starts and enters event loop

Note

Run as your user (not root). Requires X11 and input group membership.

Step 2: Check if the daemon is running and view armed shortcuts

kodachi-session-helper status

Expected Output: Daemon status with shortcut list

Step 3: Get daemon status in JSON format

kodachi-session-helper status --json

Expected Output: JSON with running state, shortcuts, and capabilities

Step 4: Reload configuration without restarting

kodachi-session-helper reload

Expected Output: Sends SIGHUP to running daemon

Note

The daemon re-reads its config and re-registers key grabs.

Scenario 2: Program Information

Getting information about the tool

Step 1: Show version

kodachi-session-helper -v

Expected Output: Version string

Step 2: Version in JSON format

kodachi-session-helper -v --json

Expected Output: JSON version envelope

Step 3: Show detailed program information

kodachi-session-helper -n

Expected Output: Features, requirements, and capabilities

Step 4: Program info in JSON format

kodachi-session-helper -n --json

Expected Output: JSON program info envelope

Step 5: Show usage examples

kodachi-session-helper -e

Expected Output: This examples listing

Step 6: Examples in JSON format

kodachi-session-helper -e --json

Expected Output: JSON examples envelope

Step 7: Show help information

kodachi-session-helper -h

Expected Output: Usage and command listing

Step 8: Help in JSON format

kodachi-session-helper -h --json

Expected Output: JSON help envelope

Environment Variables

Variable	Description	Default	Values
`DISPLAY`	X11 display to connect to	:0	:0, :1, etc.
`XDG_RUNTIME_DIR`	Runtime directory for socket and state files	/run/user/<uid>	Directory path

Exit Codes

Code	Description
0	Success
1	General error
2	Invalid arguments
3	Permission denied (running as root)
4	X11 not available
5	Wayland session (unsupported)