dots/bash
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity

update

Browse source
This commit is contained in:
Ray Elliott 2026-10-28 19:54:16 +00:00
commit d700caaa98
2 changed files with 40 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

39
AGENTS.md Normal file
View file

@ -0,0 +1,39 @@
# Repository guidance
Read `README.md` before changing startup flow, file ownership or repository
boundaries.
## Scope
- This repository owns the Bash login sequence and the complete interactive
Bash experience: prompt, history, completion, aliases, functions, reminders
and interactive integrations.
- The `profile` repository owns only the portable login environment.
- The `systemd` repository owns user services, timers and background work.
- Keep Arch-specific interactive behavior in `platform/arch.sh`.
## Change rules
- Preserve the ordered, single-purpose modules under `bashrc.d/`.
- Keep shell startup responsive. Do not add synchronous network access, package
database synchronization or other slow background checks to startup.
- Preserve the cached package-status interface documented in `README.md` unless
all producers, consumers and documentation are deliberately updated together.
- Keep `commands.tsv` and `memory.tsv` tab-separated, headerless and free of
comments; follow their corresponding README files.
- Do not edit the vendored `gitstatus/` tree as part of ordinary configuration
work.
- Update `README.md` when startup behavior, ownership or module responsibilities
change.
- Do not install packages, run system upgrades or change live systemd unit state
unless the user explicitly requests it.
## Validation
- Run `bash -n` on Bash entrypoints and `bashrc.d/*.bash`.
- Run `sh -n` on files intentionally kept in portable shell syntax.
- Run ShellCheck where available and distinguish actionable findings from
expected dynamic-source warnings.
- For startup changes, use an isolated interactive Bash subprocess and confirm
the relevant aliases and functions load without modifying the current shell.
- Run `git diff --check` before finishing.

1
memory.tsv
View file

@ -21,3 +21,4 @@ ee What opens the current directory in Neovim? ee
dusort What displays disk usage sorted by size? dusort [path] dusort What displays disk usage sorted by size? dusort [path]
debuglog What clears and follows debug.log? debuglog debuglog What clears and follows debug.log? debuglog
mkcd What creates a directory and enters it? mkcd <directory> mkcd What creates a directory and enters it? mkcd <directory>
lf-inspect How do you inspect a file in lf? Select it and press i; press q to return.

1 nap What do you use as a snippet manager? nap
21 dusort What displays disk usage sorted by size? dusort [path]
22 debuglog What clears and follows debug.log? debuglog
23 mkcd What creates a directory and enters it? mkcd <directory>
24 lf-inspect How do you inspect a file in lf? Select it and press i; press q to return.