README
¶
Sys Package (internal/sys)
Cross-platform process management utilities.
Overview
This package handles low-level OS-specific operations for process group management, signal handling, and process lifecycle control. It abstracts the differences between Unix (PGID-based) and Windows (taskkill-based) process termination strategies.
Primary Purpose
Ensure proper cleanup of CLI processes and their children, preventing zombie processes and resource leaks.
Usage
import "github.com/hrygo/hotplex/internal/sys"
// Kill process group (Unix: PGID, Windows: Job Object)
sys.KillProcessGroup(cmd, jobHandle)
// Check if process is alive
if sys.IsProcessAlive(process) {
// ...
}
// Diagnostics
result := sys.CheckCliAvailable()
if result.Available {
fmt.Printf("Claude version: %s\n", result.Version)
}
Platform Differences
| Platform | Kill Strategy |
|---|---|
| Unix/Linux | kill(-pgid, SIGKILL) |
| Windows | taskkill /F /T /PID |
Files
| File | Purpose |
|---|---|
doc.go |
Package documentation |
proc_unix.go |
Unix process management (PGID-based) |
proc_windows.go |
Windows process management (Job Object-based) |
diagnostics.go |
CLI and database health checks |
path.go |
Path utilities |
Documentation
¶
Overview ¶
Package sys provides cross-platform process management utilities.
This package handles low-level OS-specific operations for process group management, signal handling, and process lifecycle control. It abstracts the differences between Unix (PGID-based) and Windows (taskkill-based) process termination strategies.
The primary purpose is to ensure proper cleanup of CLI processes and their children, preventing zombie processes and resource leaks.
Index ¶
- func AssignProcessToJob(jobHandle uintptr, process *os.Process) error
- func CheckDatabaseHealth(dbPath string) (latencyMs int, ok bool)
- func CloseJobHandle(jobHandle uintptr)
- func ConfigDir() string
- func DataDir() string
- func ExpandPath(path string) string
- func IsProcessAlive(process *os.Process) bool
- func KillProcessGroup(cmd *exec.Cmd, jobHandle uintptr)
- func LogDir() string
- func SetupCmdSysProcAttr(cmd *exec.Cmd) (uintptr, error)
- type CheckCliResult
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func AssignProcessToJob ¶ added in v0.9.3
AssignProcessToJob is a no-op on Unix (only used on Windows).
func CheckDatabaseHealth ¶ added in v0.32.0
CheckDatabaseHealth checks if a SQLite database is accessible and returns latency. It uses a 5-second timeout to avoid blocking.
func CloseJobHandle ¶ added in v0.9.3
func CloseJobHandle(jobHandle uintptr)
CloseJobHandle is a no-op on Unix (only used on Windows).
func ConfigDir ¶ added in v0.27.0
func ConfigDir() string
ConfigDir returns the platform-specific directory for configuration files (XDG_CONFIG_HOME).
func DataDir ¶ added in v0.27.0
func DataDir() string
DataDir returns the platform-specific directory for data files (XDG_DATA_HOME).
func ExpandPath ¶ added in v0.21.0
ExpandPath expands the home directory tilde (~) and environment variables in a path.
func IsProcessAlive ¶
IsProcessAlive checks if the process is still running using Signal(0) (Unix).
func KillProcessGroup ¶
KillProcessGroup terminates the entire process tree using the negative PID (Unix). The jobHandle parameter is ignored on Unix (only used on Windows).
Types ¶
type CheckCliResult ¶ added in v0.32.0
CheckCliResult holds the result of a CLI availability check.
func CheckCliAvailable ¶ added in v0.32.0
func CheckCliAvailable() CheckCliResult
CheckCliAvailable checks if the Claude Code CLI is available and returns its version. It uses a 5-second timeout to avoid blocking.
Source Files