Files
Linux_post_install/DOC
Your Name e6fa0a4ee9
gates / consistency-and-conventions (push) Successful in 1m50s
feat: configurable AI-bridge trigger word for telegram listener
The listener's "ai " bridge prefix was hard-coded. Messages starting
with <prefix> + space (case-insensitive, literal match) are now
forwarded to Gemini; default stays "ai".

- TELEGRAM_AI_PREFIX in telegram.env (default ai), hot-reloaded per
  message like the command map — no daemon restart needed
- New 'prefix' verb: pos communication telegram listener prefix [word]
  (validated [A-Za-z0-9][A-Za-z0-9_-]*; writes telegram.env chmod 600)
- Field added to the telegram # POS_CONFIG: scope (sender header) so
  'pos config telegram' edits it too
- --status shows the current prefix; usage + POS_SUBCMDS: prefix
  (completions regenerated)
- Matching via scoped nocasematch + quoted-literal =~ prefix;
  ai_bridge_prefix() precedence: env file > env var > default ai

Verified: routing harness (default/custom/case-insensitive/reset/
fallback/unknown-command) green, CLI verb tests, dispatch smoke,
pos config render, gates 0 FAIL 0 WARN.
2026-08-27 11:04:37 -04:00
..
2026-08-26 07:28:03 -04:00

Documentation

Everything in this folder is reference material for the Linux_post_install project. The root README is the short intro + quick start; this folder holds the detail.

Document What it covers
HOWTO.md Hands-on guides per category (ai, network, docker, media, system, ssh, share, communication, entertainment): flags, recipes, config, troubleshooting
SCRIPTS.md Core installer scripts: install.sh, preinstall.sh, postinstall.sh, lib/common.sh, lib/flags.sh, lib/entertainment-lib.sh, features/autostart.sh, features/usb-automount.sh — purpose, how each works, configuration
POS.md The pos CLI: dispatcher, every pos-* command, Docker Compose / ScaleTail config, legacy wrappers, flag CLIs
APPS.md Optional apps: apps/install.sh picker, installer conventions, full app catalog
SYSTEMD.md Systemd units (autostart.service, usb-automount.service, ssh-agent.service), feature-flag gating, bash completion
DEV.md Developer guide: architecture, conventions, how to add tools/apps/features, commit guidelines
AGENT_Context_Project.md Single-source context doc for AI agents working on the repo
algorithm.md ASCII diagrams: install flow, pos dispatch, compose up, config cascade, logging, vbox lifecycle

Quick navigation