Your Name
d817c37652
gates / consistency-and-conventions (push) Successful in 26s
17-point code-level audit executed via Explorer->Architect->Builder->Tester->Reviewer;
Reviewer accepted (APPROVE_WITH_NOTES; 3 block-list items resolved):
- security: telegram sender-owner AND-gate + TELEGRAM_OWNER_ID, matrix
MATRIX_ROOM_ID fail-closed, gpg --passphrase-fd 3 (no argv secret),
/dev/tcp positional-arg form (checkport/smb-client/share-lib/NET_PROBE),
eval deny-by-default + --no-command-execution carried by both chat bridges,
tty-gated --trust; config/{telegram,matrix}.env reference templates
- ai: all ExecStart flags validated against installed llama.cpp
(requested->error, default->omit+warn, CONFIG_REQUESTED_FLAGS); single-file
hf download failure rc=1 + no .hf-meta; LLAMACPP_HOST coherent;
POS_SUBCMDS + metadata gaps closed
- tooling: lint-conventions Bash-native rewrite (~24-30x faster, rules and
output byte-identical, :num restored); pos system uninstall covers all 12
libs + scale-tail + flags dir + systemd user units (|| true) + plugin
markers; anchored .bash_completion/.bashrc removal replaces sed -i '/pos/d'
- config: canonical load_env_file in lib/config-ui.sh (CRLF strip, env-wins,
XDG, LOADED_ENV_KEYS); 9 tools migrated; entertainment-lib collapsed to
wrappers; docker-compose deliberately unmigrated (source semantics)
- tests: first committed regression suite — tests/run-tests.sh zero-dep
runner + make test; 12 files / 179 checks / 0 skip / ~52s; hard skip
contract; systemd-analyze verify on generated unit PASS
Verified: make gen idempotent; make check green; make lint 0 FAIL, 0 WARN;
make test green; bash -n clean; git diff --check clean. Audit deliverables +
agent reports + AGENT_TODO Done entry included.
Linux_post_install — Personal Bootstrap & Homelab Toolkit
One command turns a bare Debian/Ubuntu install into a fully productive machine.
What is this
After reinstalling Linux you usually need to install packages, set up SSH, configure a firewall, and install apps. This repo automates all of that in one go.
It is a personal toolkit — a bootstrap script, a unified pos CLI for everyday tasks, optional app installers, and self-hosted services via ScaleTail + Tailscale.
What you get:
- 25+ system packages installed automatically
- The
posCLI: AI (Gemini chat), network, Docker (compose + vbox VMs), media, system, SSH, share (USB over network + NFS), communication (Telegram), and entertainment (public-API plugins → Telegram) tools - Wi-Fi hotspot tools (
create_ap,wihotspot-gui) viapos network hotspot pos tree— browse the whole CLI: categories, commands, and subcommands- 15 optional desktop apps (VS Code, Brave, OBS, Tailscale, …) — pick what you want
- 119+ self-hosted services with Tailscale access (Jellyfin, Home Assistant, …)
- systemd services for SSH agent, boot-time automation, and a daily Telegram health digest (
pos system health) - Everything lands in
/usr/local/bin/— you can delete the repo after install
Quick Start
git clone https://gitea.skink-platy.ts.net/admin/Linux_post_install.git
cd Linux_post_install
./install.sh # core: packages + CLI + services + ScaleTail
./install.sh --feature # also install features/ scripts (asks before overwriting)
./install.sh --apps # also install optional desktop apps (interactive)
| Flag | What it does |
|---|---|
--feature |
Install features/ scripts to /usr/local/bin/, sets their flags |
--apps |
Interactive app picker after core install |
--full |
Core install + all apps (non-interactive) |
--dry-run |
Preview without executing |
--skip <phase> |
Skip a phase: preinstall, scripts, postinstall, scalepoint, apps |
--steps <spec> |
Run only specific phases, e.g. --steps 1,3 |
--no-color |
Disable colored output |
Documentation
| Topic | Where |
|---|---|
| Docs index | DOC/README.md |
pos HOW-TO guides (recipes + troubleshooting) |
DOC/HOWTO.md |
| Core scripts (installer, libs, features) — how they work + config | DOC/SCRIPTS.md |
pos CLI reference (all commands, compose config, wrappers) |
DOC/POS.md |
| Optional apps (picker + full catalog) | DOC/APPS.md |
| Systemd services & bash completion | DOC/SYSTEMD.md |
| Developer guide (add tools/apps/features) | DOC/DEV.md |
| Algorithm diagrams | DOC/algorithm.md |