chp-adapter-launchd

Govern macOS launchd LaunchAgent services as CHP capabilities. Built so CHP can manage its own long-running infrastructure (e.g. the TEI and vLLM Metal servers) — making them persistent across reboot and controllable through the capability host with a full evidence trail.

Capabilities

Capability	Description
`chp.adapters.launchd.list`	List CHP-managed services (scoped to the managed prefix).
`chp.adapters.launchd.status`	Loaded/running state, pid, last exit code, plist presence.
`chp.adapters.launchd.start`	Bootstrap if unloaded, else `kickstart -k` (restart).
`chp.adapters.launchd.stop`	Bootout a loaded service.
`chp.adapters.launchd.install`	Generate a plist from a spec, write it, and bootstrap.
`chp.adapters.launchd.uninstall`	Bootout and remove the plist.

Safety

The adapter only manages labels matching LaunchdConfig.managed_prefix (default com.chp.) — it will refuse to touch arbitrary system services. launchctl and plist I/O are isolated in _backends.py.

Install a service (example: the TEI server)

{
  "label": "com.chp.tei",
  "program": "/opt/homebrew/bin/text-embeddings-router",
  "args": ["--model-id", "sentence-transformers/all-MiniLM-L6-v2", "--port", "8090"],
  "stdout_path": "/Users/me/.chp/logs/tei.log",
  "stderr_path": "/Users/me/.chp/logs/tei.err",
  "keep_alive": true,
  "run_at_load": true
}

Evidence policy

Emitted: label, operation, pid, returncode, plist path, environment keys, latency. Never emitted: environment variable values (may hold tokens) or plist file contents.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

chp_adapter_launchd-0.23.0-py3-none-any.whl (8.5 kB view details)

Uploaded Jul 12, 2026 Python 3

File details

Details for the file chp_adapter_launchd-0.23.0-py3-none-any.whl.

File metadata

Download URL: chp_adapter_launchd-0.23.0-py3-none-any.whl
Upload date: Jul 12, 2026
Size: 8.5 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.12.7

File hashes

Hashes for chp_adapter_launchd-0.23.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`d88409c24340b58b4eaa4f5e3e0454c3eb7d961b0db066c5576e13c4290f55e5`
MD5	`57630f96d6d8c91ae0c8a8e417276a84`
BLAKE2b-256	`0b803a344578ace2189aeb952cee15f1fa85af5dd907e70e51d96baa0bf3640e`