Your Name 528b16676e
gates / consistency-and-conventions (push) Successful in 2m16s
fix: review-driven hardening of pos ai hf/server + llamacpp provider
Adversarial review of the AI tools (commits 387f23f/0856b25) found 2
BLOCKING + 5 REQUIRED defects; all fixed:

- pos-ai-hf --include/--exclude: bash-case glob filtering (array-safe,
  no jq regex interpolation, composes gguf->filename->include->exclude)
- pos-ai-server: ExecStart rebuilt as single-line properly-quoted command
  (systemd_quote for executable + model path; systemd-analyze verify rc=0)
- --branch/--revision aliased (last wins), dead BRANCH variable removed
- parallel download drains all jobs: per-pid wait, honest
  'X of Y files, N failed' summary, rc=1 on partial failure, no .hf-meta
  for half-downloaded models, EXIT-trap temp cleanup
- detect_llama_version guarded; validate_requested_flags errors on
  unsupported explicit flags with version-aware message
- pos ai hf cache [status|clear]: real implementation, fail-closed confirm
- new bin/pos-ai-llamacpp thin forwarder + llamacpp shorthand in bin/pos-ai
  (pos ai llamacpp <subcmd> = pos ai --provider llamacpp <subcmd>)
- docs synced: bin/pos-ai usage(), DOC/POS.md AI_PROVIDER row, howto/ai.md
  (adapter list, --provider backends, shorthand, providers table); gen
  regenerated (tree/dispatch/completions)

Verified: bash -n all bin/pos*; make gen idempotent; make check green;
make lint 0 FAIL, 0 WARN. Reviewer acceptance: APPROVE_WITH_NOTES
(0 REQUIRED). Audit deliverables + agent reports included for context.
2026-09-06 03:45:53 -04:00
2026-09-04 11:09:21 -04:00
.
2026-07-28 10:28:11 -04:00
.
2026-08-21 09:53:10 -04:00
2026-09-04 11:09:21 -04:00
2026-09-04 11:09:21 -04:00

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 pos CLI: 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) via pos 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
S
Description
No description provided
Readme 14 MiB
Languages
Shell 99.9%