admin/Linux_post_install
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity

feat: add pos bank — persistent command bank with parameterized templates
gates / consistency-and-conventions (push) Successful in 29s
Details

Browse Source
This commit is contained in:
Your Name
2026-09-12 03:02:20 -04:00
parent 0b76d4d29e
commit 41efc91cf0
10 changed files with 886 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files
DOC/AGENT_Context_Project.md
+17 -14
View File
@@ -10,19 +10,19 @@
<!-- GEN:START docmap -->
| ## 1. Project Overview | 28–43 |
| ## 2. Directory Structure | 44–217 |
| ## 3. Installation Flow | 218–276 |
| ## 4. The `pos` CLI System | 277–365 |
| ## 5. Shared Library — `lib/common.sh` | 366–397 |
| ## 6. Docker Compose / ScaleTail | 398–440 |
| ## 7. Optional Apps (`apps/`) | 441–470 |
| ## 8. Entertainment Module | 471–484 |
| ## 9. Systemd Services | 485–496 |
| ## 10. Configuration Files | 497–523 |
| ## 11. Coding Conventions | 524–556 |
| ## 12. Development Workflow | 557–609 |
| ## 13. Key File Quick Reference | 610–693 |
| ## 14. Common Tasks for Agents | 694–727 |
| ## 2. Directory Structure | 44–218 |
| ## 3. Installation Flow | 219–277 |
| ## 4. The `pos` CLI System | 278–367 |
| ## 5. Shared Library — `lib/common.sh` | 368–399 |
| ## 6. Docker Compose / ScaleTail | 400–442 |
| ## 7. Optional Apps (`apps/`) | 443–472 |
| ## 8. Entertainment Module | 473–486 |
| ## 9. Systemd Services | 487–498 |
| ## 10. Configuration Files | 499–525 |
| ## 11. Coding Conventions | 526–558 |
| ## 12. Development Workflow | 559–611 |
| ## 13. Key File Quick Reference | 612–696 |
| ## 14. Common Tasks for Agents | 697–730 |
<!-- GEN:END docmap -->
## 1. Project Overview
@@ -117,6 +117,7 @@ Linux_post_install/
│ ├── pos-system-schedule # Scheduled jobs: run a command on a timer; notify on threshold/change/error/always or silently
│ ├── pos-system-uninstall # Remove pos toolkit binaries, services, shell integration, config, and data
│ ├── pos-ai # AI assistant: ask, chat, sessions, capture, models, providers
│ ├── pos-bank # Persistent command bank for saving and running shell commands
│ ├── pos-config # Interactive editor for the tools' runtime config (reads # POS_CONFIG: registry)
│ ├── pos-tree # Show the pos CLI command tree: categories, commands, and subcommands
<!-- GEN:END tree -->
@@ -343,6 +344,7 @@ All non-interactive `pos` commands log output to `~/.local/share/linux_post_inst
| system | schedule | `pos-system-schedule` | Scheduled jobs: run a command on a timer; notify on threshold/change/error/always or silently | | |
| system | uninstall | `pos-system-uninstall` | Remove pos toolkit binaries, services, shell integration, config, and data | | |
| | ai | `pos-ai` | AI assistant: ask, chat, sessions, capture, models, providers | | |
| | bank | `pos-bank` | Persistent command bank for saving and running shell commands | | |
| | config | `pos-config` | Interactive editor for the tools' runtime config (reads # POS_CONFIG: registry) | | |
| | tree | `pos-tree` | Show the pos CLI command tree: categories, commands, and subcommands | | |
<!-- GEN:END dispatch -->
@@ -683,9 +685,10 @@ Use conventional prefixes: `feat:`, `fix:`, `docs:`, `refactor:`, `chore:`
| `bin/pos-system-schedule` | 151 | Scheduled jobs: run a command on a timer; notify on threshold/change/error/always or silently |
| `bin/pos-system-uninstall` | 517 | Remove pos toolkit binaries, services, shell integration, config, and data |
| `bin/pos-ai` | 714 | AI assistant: ask, chat, sessions, capture, models, providers |
| `bin/pos-bank` | 313 | Persistent command bank for saving and running shell commands |
| `bin/pos-config` | 80 | Interactive editor for the tools' runtime config (reads # POS_CONFIG: registry) |
| `bin/pos-tree` | 118 | Show the pos CLI command tree: categories, commands, and subcommands |
| `completions/pos.bash` | 317 | Dynamic bash completion |
| `completions/pos.bash` | 318 | Dynamic bash completion |
<!-- GEN:END filetable -->
| `apps/install.sh` | 171 | App install/uninstall picker/orchestrator |
DOC/POS.md
+24
View File
@@ -534,6 +534,30 @@ Feature-flag management CLIs (see [SCRIPTS.md → lib/flags.sh](SCRIPTS.md#libfl
| `flag-set <name> [value]` | Set a flag, optionally with a value (requires sudo) |
| `flag-clear <name>` | Unset a flag (requires sudo) |
### bank
**File:** `bin/pos-bank`
Persistent command bank for saving and running shell commands. Commands are stored in `~/.config/linux_post_install/bank.env` (pipe-delimited: `name|description|command`). Supports parameterized templates with `{param}` placeholders that are substituted at run time (quoted for safe shell evaluation).
On a TTY with no arguments, `pos bank` opens an interactive menu (list / add / run / edit / remove).
| Command | Purpose |
|---------|---------|
| `pos bank list` | List all saved commands |
| `pos bank add <name> [desc] [cmd]` | Add a new command (interactive for missing args) |
| `pos bank show <name>` | Show command details and detected parameters |
| `pos bank run <name> [key=val …]` | Run a command (interactive for missing params) |
| `pos bank edit <name>` | Edit an existing command |
| `pos bank remove <name>` | Remove a command |
Example with parameters:
```
pos bank add convert "Convert video" "ffmpeg -i {input} -crf {quality} {output}"
pos bank run convert input=clip.mp4 quality=23 output=clip.mkv
```
### config
**File:** `bin/pos-config`