mirror of
https://github.com/tildeclub/launcher.git
synced 2026-10-25 08:25:38 +00:00
92 lines
2.5 KiB
Groff
92 lines
2.5 KiB
Groff
.TH TILDE 1 "October 2026" "Tilde User Scripts" "User Commands"
|
|
.SH NAME
|
|
tilde \- submit, review and run approved community scripts
|
|
.SH SYNOPSIS
|
|
.B tilde
|
|
[\fIOPTION\fR] [\fICOMMAND\fR]
|
|
.SH DESCRIPTION
|
|
The tilde launcher provides a submission and administrator approval process
|
|
for community scripts. Approved executables are accessible from /tilde/bin.
|
|
New approvals use reviewed, root-owned copies rather than mutable links to
|
|
the submitting user's home directory.
|
|
.SH OPTIONS
|
|
.TP
|
|
.B -h, --help
|
|
Show usage and exit.
|
|
.TP
|
|
.B -v, --version
|
|
Show the version and exit.
|
|
.SH COMMANDS
|
|
.TP
|
|
.B list
|
|
List approved scripts with author and description.
|
|
.TP
|
|
.B about \fIscript\fR
|
|
Show its description and author. Alias: description.
|
|
.TP
|
|
.B submit
|
|
Submit an executable in ~/bin for approval.
|
|
.TP
|
|
.B update \fIscript\fR
|
|
Submit a new revision of a script that you own. The approved version remains
|
|
available until the revision is accepted.
|
|
.TP
|
|
.B pending
|
|
List your submissions that are not yet approved.
|
|
.TP
|
|
.B status \fIscript\fR
|
|
Show the script's approval and submission status.
|
|
.TP
|
|
.B run \fIscript\fR [\fIarguments\fR]
|
|
Run an approved script, forwarding its arguments.
|
|
.TP
|
|
.B approve
|
|
Interactively approve, reject or skip pending submissions (root only).
|
|
.TP
|
|
.B revoke \fIscript\fR
|
|
Revoke a previously approved script after confirmation (root only).
|
|
.TP
|
|
.B migrate [\fIscript\fR]
|
|
Interactively review and migrate legacy user-owned symlinks (root only).
|
|
When no name is given, review all legacy links.
|
|
.TP
|
|
.B init
|
|
Initialize secured launcher directories (root only). Does not alter
|
|
existing approved links.
|
|
.SH FILES
|
|
.TP
|
|
.I /tilde/bin
|
|
Published command names.
|
|
.TP
|
|
.I /tilde/approved
|
|
Root-owned reviewed versions.
|
|
.TP
|
|
.I /tilde/descriptions
|
|
Published descriptions.
|
|
.TP
|
|
.I /tilde/metadata
|
|
Root-owned approval records.
|
|
.TP
|
|
.I /tilde/rejected
|
|
Root-owned rejection fingerprints.
|
|
.TP
|
|
.I /tilde/pending-submissions
|
|
User-managed pending snapshots.
|
|
.TP
|
|
.I /tilde/review
|
|
Private root-owned temporary review area.
|
|
.SH NOTES
|
|
An administrator approves an immutable snapshot of a submitted script. The
|
|
script is captured under the submitter's user ID; it is not executed as root.
|
|
Legacy links are not changed until an administrator explicitly migrates them.
|
|
Single-file scripts are supported; executables requiring files beside them may
|
|
need packaging changes before migration.
|
|
.PP
|
|
To run approved scripts directly, append /tilde/bin to your PATH.
|
|
.SH AUTHOR
|
|
Ben Harris <ben@tilde.team>
|
|
.SH COPYRIGHT
|
|
Copyright (C) 2018 Ben Harris.
|
|
.SH LICENSE
|
|
GPL-3.0-or-later. See LICENSE.
|