Crate cli 

Modules

apps

bin_links

bun_runtime

colors

commands

completion

config

env

git_pull

home

Home-directory resolution and path expansion helpers.

info

init

install_core

Install/uninstall primitives shared by the apps and sys preset domains: manifest tracking (manifest), file write/backup/admin-lock logic (file_ops), and content transforms (transforms).

list

output

path_display

persist

Shared atomic-write primitives.

platform

preset_commands

preset_meta

Shared primitives for apps::metadata and shells::metadata’s shine.toml/category loaders: embedded-category-name discovery, filesystem-category-name discovery, platform filtering, and the filesystem tree walk + base/overlay merge used to auto-collect files for categories without an explicit [[files]] list.

preset_validation

Read-only preset discovery, validation reporting, and stable JSON output.

presets

privilege

proc

Small subprocess-related helpers with no domain-specific logic.

secret

Secret storage backends for shine env secret encrypt/decrypt.

self_install

sentinel

Shared sentinel-block primitives used by shells::profile and sys::profile to find, extract, remove, and insert the # >>> ... >>> / # <<< ... <<< blocks shine writes into user-owned shell profile files.

serve

shell_quote

Shared POSIX shell-quoting helpers for rendering commands back into copy-paste-safe or sourceable shell syntax. Display-only: task::mod and apps::upgrade never execute the quoted string itself, they always run the underlying argv directly via std::process::Command/tokio::process::Command, so this module has no injection surface of its own.

shells

shim

Top-level shine install/uninstall <target> shims: they resolve canonical or unambiguous preset targets and delegate to the corresponding handler.

ssh

shine ssh: wraps the system ssh binary to establish an interactive session that also carries a session-scoped file-transfer channel back to the local machine (see docs/ssh-local-transfer-prd.md).

state

status

Shared install-status row builders consumed by list and info.

sys

task

shine task — a lightweight personal shortcut-command registry.

test_support

Shared test-only utilities.

theme

shine theme sync: resolves the terminal’s light/dark theme and prints shell-safe export statements for SHINE_TERMINAL_THEME and BAT_THEME. See docs/terminal-theme-sync-prd.md for the full design and docs/kb/lessons.md (2026-07-14) for why the old shell-only OSC read loop was replaced.

update_check

version