From 48e6a96c6df8c45a2763c0e8c964ce26209fca29 Mon Sep 17 00:00:00 2001 From: rootiest Date: Sun, 26 Jul 2026 22:43:24 -0400 Subject: [PATCH 1/3] docs: use aside syntax for caution block and update intro text --- docs/fish-config.md | 22 ++++++++++------------ docs/manual/index.md | 22 ++++++++++------------ 2 files changed, 20 insertions(+), 24 deletions(-) diff --git a/docs/fish-config.md b/docs/fish-config.md index 2aa98c3..952421c 100644 --- a/docs/fish-config.md +++ b/docs/fish-config.md @@ -39,19 +39,17 @@ A production-grade Fish shell configuration targeting Fish 4.x. It provides: - AI session helpers for Claude Code and Antigravity - Catppuccin Mocha color theme throughout -> **CAUTION - SESSION LOGGING IS ON BY DEFAULT** -> -> This configuration silently records terminal output to `~/.terminal_history`: -> Kitty scrollback on window close, live tmux pane streams, zellij pane -> snapshots on exit, and full paru/yay output. These logs can contain command -> output, file contents, and secrets printed to the terminal. Nothing leaves -> your machine, but the files persist locally. -> -> - Disable all logging with: `set -U __fish_config_op_logging off` -> - Prefer a menu? Run the interactive picker: `config-settings` -> - See Section 7 (C5 - Logging and Capture) for the full breakdown. +CAUTION: **SESSION LOGGING IS ON BY DEFAULT** +This configuration silently records terminal output to `~/.terminal_history`: +Kitty scrollback on window close, live tmux pane streams, zellij pane +snapshots on exit, and full paru/yay output. These logs can contain command +output, file contents, and secrets printed to the terminal. Nothing leaves +your machine, but the files persist locally. +- Disable all logging with: `set -U __fish_config_op_logging off` +- Prefer a menu? Run the interactive picker: `config-settings` +- See Section 7 (C5 - Logging and Capture) for the full breakdown. -The configuration is split across: +The configuration uses a structured file tree: ~/.config/fish/ ├── config.fish Main entry point; sets env vars and PATH diff --git a/docs/manual/index.md b/docs/manual/index.md index 9d7923c..feee0d9 100644 --- a/docs/manual/index.md +++ b/docs/manual/index.md @@ -24,19 +24,17 @@ A production-grade Fish shell configuration targeting Fish 4.x. It provides: - AI session helpers for Claude Code and Antigravity - Catppuccin Mocha color theme throughout -> **CAUTION - SESSION LOGGING IS ON BY DEFAULT** -> -> This configuration silently records terminal output to `~/.terminal_history`: -> Kitty scrollback on window close, live tmux pane streams, zellij pane -> snapshots on exit, and full paru/yay output. These logs can contain command -> output, file contents, and secrets printed to the terminal. Nothing leaves -> your machine, but the files persist locally. -> -> - Disable all logging with: `set -U __fish_config_op_logging off` -> - Prefer a menu? Run the interactive picker: `config-settings` -> - See Section 7 (C5 - Logging and Capture) for the full breakdown. +CAUTION: **SESSION LOGGING IS ON BY DEFAULT** +This configuration silently records terminal output to `~/.terminal_history`: +Kitty scrollback on window close, live tmux pane streams, zellij pane +snapshots on exit, and full paru/yay output. These logs can contain command +output, file contents, and secrets printed to the terminal. Nothing leaves +your machine, but the files persist locally. +- Disable all logging with: `set -U __fish_config_op_logging off` +- Prefer a menu? Run the interactive picker: `config-settings` +- See Section 7 (C5 - Logging and Capture) for the full breakdown. -The configuration is split across: +The configuration uses a structured file tree: ~/.config/fish/ ├── config.fish Main entry point; sets env vars and PATH From c1262969353b903e24272f418954450c3cff0680 Mon Sep 17 00:00:00 2001 From: rootiest Date: Sun, 26 Jul 2026 22:52:35 -0400 Subject: [PATCH 2/3] docs: add LinkButton call-to-actions to the manual index --- docs/build-manual.py | 2 +- docs/fish-config.md | 3 +++ docs/manual/index.md | 3 +++ 3 files changed, 7 insertions(+), 1 deletion(-) diff --git a/docs/build-manual.py b/docs/build-manual.py index 3154a20..9b5ca5b 100644 --- a/docs/build-manual.py +++ b/docs/build-manual.py @@ -597,7 +597,7 @@ def _split_entries(body: str) -> tuple[str, list[tuple[str, str]]]: return intro, entries -ASTRO_ASIDE_COMPONENTS = {" None: diff --git a/docs/fish-config.md b/docs/fish-config.md index 952421c..a5ce4c8 100644 --- a/docs/fish-config.md +++ b/docs/fish-config.md @@ -39,6 +39,9 @@ A production-grade Fish shell configuration targeting Fish 4.x. It provides: - AI session helpers for Claude Code and Antigravity - Catppuccin Mocha color theme throughout +Install now +Function reference + CAUTION: **SESSION LOGGING IS ON BY DEFAULT** This configuration silently records terminal output to `~/.terminal_history`: Kitty scrollback on window close, live tmux pane streams, zellij pane diff --git a/docs/manual/index.md b/docs/manual/index.md index feee0d9..32c8daf 100644 --- a/docs/manual/index.md +++ b/docs/manual/index.md @@ -24,6 +24,9 @@ A production-grade Fish shell configuration targeting Fish 4.x. It provides: - AI session helpers for Claude Code and Antigravity - Catppuccin Mocha color theme throughout +Install now +Function reference + CAUTION: **SESSION LOGGING IS ON BY DEFAULT** This configuration silently records terminal output to `~/.terminal_history`: Kitty scrollback on window close, live tmux pane streams, zellij pane From 25fb02b7ac91b35be7cf94134495794ce66b80a7 Mon Sep 17 00:00:00 2001 From: rootiest Date: Sun, 26 Jul 2026 22:55:12 -0400 Subject: [PATCH 3/3] build(docs): strip LinkButton from concatenated terminal output --- docs/build-manual.py | 1 + docs/fish-config.md | 3 --- 2 files changed, 1 insertion(+), 3 deletions(-) diff --git a/docs/build-manual.py b/docs/build-manual.py index 9b5ca5b..2fb878b 100644 --- a/docs/build-manual.py +++ b/docs/build-manual.py @@ -78,6 +78,7 @@ def build_concat(root: Path) -> str: if _is_function_page(path, root): body = _with_entries(body, path, entries) if body: + body = re.sub(r"\n*", "", body, flags=re.DOTALL) chunks.append(mt.shift_headings(body, depth)) return "\n\n".join(chunks) + "\n" diff --git a/docs/fish-config.md b/docs/fish-config.md index a5ce4c8..952421c 100644 --- a/docs/fish-config.md +++ b/docs/fish-config.md @@ -39,9 +39,6 @@ A production-grade Fish shell configuration targeting Fish 4.x. It provides: - AI session helpers for Claude Code and Antigravity - Catppuccin Mocha color theme throughout -Install now -Function reference - CAUTION: **SESSION LOGGING IS ON BY DEFAULT** This configuration silently records terminal output to `~/.terminal_history`: Kitty scrollback on window close, live tmux pane streams, zellij pane