Caution
【重要】これは個人専用のバックアップリポジトリです 本リポジトリは、作者の特定のハードウェアおよび環境 （Arch Linux / Windows 11 デュアルブート）に依存した個人用設定です。 汎用テンプレートや、他人がそのまま導入するためのものではありません。
特にSecure Boot関連の設定やハードウェア固有のスクリプトは、 そのまま実行すると最悪の場合**システムが起動しなくなる、 あるいはデータが破損する恐れ（ランドマイン）**があります。 内容を十分に理解せずにコピー＆ペーストしたり、 スクリプトを実行したりしないでください。
このリポジトリは、作者（seekerkrt）の設定ファイルを管理・同期するためのものです。 GNU Stowによるホームディレクトリへの展開、自作systemd unit / drop-inの配置、 Secure Boot運用スクリプト、パッケージ一覧のバックアップなどを含みます。
本リポジトリはGitHubを本家として運用されており、GitLab上の同名リポジトリはバックアップミラーです。主な更新元はGitHubです。 また、秘密鍵やトークンなどの機密情報は管理対象外となっています。
.
├── stow/ # GNU Stowで展開するユーザー設定
│ ├── alacritty/ # Alacritty設定
│ ├── antigravity/ # Antigravity IDE設定
│ ├── bash/ # Bash設定
│ ├── btop/ # btop設定
│ ├── cargo/ # Cargo設定
│ ├── ccache/ # ccache設定
│ ├── chrome/ # Chrome設定
│ ├── clang-format/ # clang-format設定
│ ├── claude/ # Claude Code設定（→ エージェント設定の参照先）
│ ├── codex/ # Codex設定（→ エージェント設定の参照先）
│ ├── conky/ # Conky設定
│ ├── emacs/ # Emacs設定
│ ├── env/ # 環境変数設定
│ ├── fonts/ # フォント設定
│ ├── foot/ # footターミナル設定
│ ├── gemini/ # Antigravity CLI設定（→ エージェント設定の参照先）
│ ├── git/ # Git設定
│ ├── grok/ # Grok設定（→ エージェント設定の参照先）
│ ├── hypr/ # Hyprland設定
│ ├── kde/ # KDE設定
│ ├── mako/ # mako通知ツール設定
│ ├── markdownlint/ # markdownlint設定
│ ├── npm/ # npm設定
│ ├── nvim/ # Neovim設定
│ ├── scripts/ # 個人用スクリプト
│ ├── sway/ # Sway設定
│ ├── tmux/ # tmux設定
│ ├── tmuxp/ # tmuxp設定
│ ├── vim/ # Vim設定
│ ├── vscode/ # VS Code設定
│ ├── waybar/ # Waybar設定
│ ├── wezterm/ # WezTerm設定
│ ├── xorg/ # X.Org設定
│ ├── yazi/ # yaziファイラー設定
│ ├── zsh/ # Zsh設定
│ └── zsh-functions/ # Zsh関数
├── systemd/ # 自作systemd unit / drop-in（Stow管理対象外）
│ ├── system/ # → /etc/systemd/system/ へ配置
│ │ └── clamav-clamonacc.service.d/
│ │ └── override.conf
│ └── user/ # → ~/.config/systemd/user/ へ配置
│ └── ssh-agent.service
├── system/secureboot/ # Secure Boot関連の設定とスクリプト
├── pkglist/ # 明示インストール済みパッケージ一覧
├── sample/ # システム設定ファイルのサンプル
├── docs/ # 補助ドキュメント
│ └── AI-CODINGAGENTS-INSTALLATIONS.md # AI CLIの導入経路と更新方法
├── apply-stow.sh # Stowリンクを作成
├── remove-stow.sh # Stowリンクを削除
├── setup-systemd-services.sh # systemd unit / drop-inの配置とenable状態の再現
├── update-pkglist.sh # パッケージ一覧を更新
├── restore-pkglist.sh # パッケージ一覧から復元
├── backup-ssh-allowlist.sh # SSH鍵と設定を暗号化バックアップ
├── restore-ssh-allowlist.sh # 暗号化したSSH鍵と設定を復元
├── backup-ssh-config.sh # SSH設定のみを暗号化バックアップ
├── restore-ssh-config.sh # 暗号化したSSH設定のみを復元
└── setup-system.sh # システム側設定を配置
Important
共通契約の正本は stow/codex/.codex/AGENTS.md の1つだけです。
CLAUDE.md は @~/.codex/AGENTS.md でCodex正本をimportし、
GEMINI.md はそこからの一方向同期による移植版です。
どちらもエージェント固有の差分だけを局所的に持ちます。
共通ルールを変更する場合は、必ずCodex正本を先に直してください。
各エージェントが実際に読むファイルと、このリポジトリ内での実体の対応は次のとおりです。
| エージェント | リポジトリ内の実体 | 実際の参照先 | 内容 |
|---|---|---|---|
| Codex | stow/codex/.codex/AGENTS.md |
~/.codex/AGENTS.md |
共通契約の正本 |
| Codex | stow/codex/.agents/skills/ |
~/.agents/skills/ |
Skill 9種 |
| Codex | stow/codex/.codex/*.config.toml |
~/.codex/ |
モデル別プロファイル |
| Claude Code | stow/claude/.claude/CLAUDE.md |
~/.claude/CLAUDE.md |
Codex正本のimport＋固有差分 |
| Claude Code | stow/claude/.claude/skills/ |
~/.claude/skills/ |
Skill 9種 |
| Claude Code | stow/claude/.claude/settings.json |
~/.claude/settings.json |
権限、モデル、プラグイン等 |
| Antigravity CLI | stow/gemini/.gemini/GEMINI.md |
~/.gemini/GEMINI.md |
Codex正本からの移植 |
| Antigravity CLI | stow/gemini/.gemini/antigravity-cli/skills/ |
~/.gemini/antigravity-cli/skills/ |
Skill 9種 |
| Grok | stow/grok/.grok/config.toml |
~/.grok/config.toml |
CLI / UI / marketplace 設定 |
SkillはCodex・Claude Code・Antigravity CLIの3エージェント共通で次の9種を配置しています。
audit commit-prep cpp-conventions github
handoff handoff-inline handoff-archive issue-slice verify
Note
Claude Codeだけは verify ではなく verify-diff という名前です。
verify が組み込みコマンドと衝突するため、意図的にリネームしています。
中身の契約は他エージェントの verify と同じです。
issue-sliceはGitHub Issueまたは明示されたPR単位でscope / non-scopeを固定し、
既存のaudit、cpp-conventions、verify（Claude Codeではverify-diff）、
commit-prep、github、handoffへ必要な段階でroutingしながら、
最小実装と検証を進めてcommit前で停止するオーケストレータです。
長いtest、build、release-check、compiler、runtime、diff等の作業logは、
repositoryへ追加せず~/handoff/<repo>/<scope>/へtimestamp付きfilenameで保存します。
最終報告にはraw logを貼らず、pass / fail、保存path、重要な要点だけを記載します。
handoff系3種（handoff / handoff-inline / handoff-archive）は、
front matterを除いた本文を3エージェントで一致させる運用です。
handoff-inline の親Skill参照パスだけがエージェント固有差分として許容されます。
Warning
~/.gemini はディレクトリごとsymlinkされています。
このためAntigravity CLIの実行時データ（history.jsonl、log/、
conversations/、brain/ 等）もこのリポジトリ配下へ書き込まれます。
これらは .gitignore で除外済みで、追跡対象は GEMINI.md、
settings.json、skills/ のみです。
Codex・Claude Codeはファイル／ディレクトリ単位のsymlinkのため、この問題はありません。
Grokも config.toml だけのfile symlinkです。
~/.grok は実ディレクトリのまま残り、共通契約の正本やSkill 9種の複製は
stow/grok には置いていません。auth.json、sessions/、logs/ などの
実行時データはホーム側に残り、このリポジトリの追跡対象外です。
各CLIの導入経路、現在の配置、更新コマンドは
docs/AI-CODINGAGENTS-INSTALLATIONS.md を正本とします。
| CLI | 導入経路 | Command |
|---|---|---|
| Codex | npm global | codex |
| Claude Code | 公式native installer | claude |
| Grok | npm global | grok |
| Antigravity CLI | 公式installer + dotfiles管理のwrapper | agy |
4種をまとめて更新するスクリプトは stow/scripts/.local/bin/update-ai-cli.sh です。
Stow展開後は ~/.local/bin/update-ai-cli.sh として実行できます。
update-ai-cli.shCLIごとにPATH上の実体と更新前後のversionを表示し、<command> update を
codex → claude → grok → agy の順で実行します。
PATHに無いCLIはSKIP扱いで中断せず、1つでも失敗した場合は終了コード1を返します。
新規Arch環境での初期構築は、各スクリプトの責務に沿って次の順で実行します。
- パッケージの復旧:
./restore-pkglist.sh - $HOME側設定の適用:
./apply-stow.sh - システム側（Secure Boot）設定の配置:
sudo ./setup-system.sh - systemd unit / drop-inの配置とenable:
./setup-systemd-services.sh --apply - 必要に応じてSSH設定の復元:
./restore-ssh-config.sh BACKUP_DIR（鍵も含める場合は./restore-ssh-allowlist.sh BACKUP_DIR）
全部をまとめて実行するbootstrapスクリプトはありません。上記を個別に実行します。
ホームディレクトリ（$HOME）に設定ファイルのシンボリックリンクを展開します。
./apply-stow.sh（vscode パッケージ全体と、codex パッケージの .codex subtreeには
--no-folding が適用されます。Codex Skillは
~/.agents/skills/<skill> のdirectory symlinkとして展開されます。）
Important
systemd unit / drop-in / enable状態はStowの管理対象外です。
これらは systemd/ と setup-systemd-services.sh が管理元です。
apply-stow.sh / remove-stow.sh は旧パッケージ名 systemd-user を
SKIP_PACKAGES として除外しています。パッケージ自体は削除済みで、
この指定は誤ってStow管理へ戻さないためのガードとして残しています。
Stowが同じパスへsymlinkを張ると、setupスクリプトが配置した実ファイルと
conflictするためです。
普段インストールしているパッケージの一覧を管理します。 ・リストの更新（現在の状態を保存）:
./update-pkglist.sh・パッケージの復元（クリーンインストール時など）:
./restore-pkglist.sh（自動的に公式パッケージは pacman、AURパッケージは yay または paru を検出して --needed でインストールします）
秘密鍵を含むため、リポジトリにコミットしたくない ~/.ssh 以下の重要ファイルを、
ユーザーが指定した外部ディレクトリ（BACKUP_DIR）へGPG暗号化して退避します。
どちらのスクリプトも BACKUP_DIR が必須引数で、リポジトリ内には保存しません。
・バックアップ（~/.ssh/config、id_ed25519、id_ed25519.pub のみ。
authorized_keys / known_hosts / known_hosts.old は除外）:
./backup-ssh-allowlist.sh /path/to/secure-backup-dir・復元:
./restore-ssh-allowlist.sh /path/to/secure-backup-dir対象ファイルは BACKUP_DIR/ssh-backup.tar.gz.gpg です。
バックアップ側は BACKUP_DIR が存在しない場合は中止し、既存バックアップは
タイムスタンプ付き .bak へローテーションしてから置き換えます。
復元側はアーカイブ内容をallowlistで検証し、~/.ssh が存在して空でない場合は
上書きを拒否します。
また、~/.ssh/config のみを取り扱うバックアップ・復元スクリプトも用意されています。
・SSH設定のみバックアップ:
./backup-ssh-config.sh /linuxshare/Backup・SSH設定のみ復元:
./restore-ssh-config.sh /linuxshare/Backup/linuxshare/Backup は例であり固定パスではありません。
対象ファイルは一般形で BACKUP_DIR/ssh-config.tar.gz.gpg です。
バックアップ側の挙動:
BACKUP_DIRは必須引数- 指定ディレクトリは事前に存在している必要がある（スクリプトは自動作成しない）
- 対象は
~/.ssh/configのみ - GPG symmetric encryption（
gpg -c）で暗号化する - 出力先は
BACKUP_DIR/ssh-config.tar.gz.gpg
復元側の挙動:
BACKUP_DIRは必須引数BACKUP_DIR/ssh-config.tar.gz.gpgから復元する- 復元先は
~/.ssh/configのみ - アーカイブ内容を検証し、
.ssh/config以外を含む場合は中止する - 既存の
~/.ssh/configはタイムスタンプ付き.bakへ退避してから上書きする ~/.sshを700、~/.ssh/configを600へ設定する~/.sshや~/.ssh/configがsymlinkの場合は拒否する
sudo ./setup-system.shこれにより、GRUB更新時に自動で署名をやり直す pacman フックや、 専用のバックアップ・リストアスクリプトが /usr/local/sbin に入ります。 詳細な復旧手順は system/secureboot/README.md を参照してください。
systemd/ 配下の自作unitとdrop-inを配置し、明示管理しているunitの
永続enable状態を再現します。
systemd unit / drop-in / enable状態はGNU Stowではなく、
systemd/ と setup-systemd-services.sh が管理元です。
・dry-run（引数なし・既定）:
./setup-systemd-services.shファイルシステムもsystemdの状態も変更せず、何が行われるかだけを表示します。
・適用:
./setup-systemd-services.sh --apply自作unit / drop-inを配置し、必要なunitの永続enable状態を再現します。 処理順は次で固定です。
custom system / user unit・drop-inの配置
→ 必要な場合だけdaemon-reload
→ system unitのenable
→ user unitのenable
・適用後にinactiveなunitだけ起動:
./setup-systemd-services.sh --apply --now--now はinactiveなunitのstartだけを行い、restart / stopはしません。
現在の実装の安全方針:
- パッケージのインストールは行わない
- disableしない
- mask / unmaskしない
- stopしない
- restartしない
- masked unitは手動対応としてskipし、勝手に変更しない
- 存在しないunitはパッケージ未導入の可能性として記録し、中断しない
- 配置するのはdotfilesが持つ自作unitとdrop-inだけで、 パッケージ提供のunit本体はshadowしない
Caution
[CRITICAL] Personal Backup Repository Only This repository contains personal configuration files tailored to the author's hardware and environment (Arch Linux / Windows 11 dual-boot). It is NOT a general-purpose template or a reusable setup guide.
In particular, the Secure Boot recovery scripts and hardware-specific configuration could render your system unbootable or cause data loss if executed blindly. Do not copy-paste or execute these scripts unless you thoroughly understand the code.
This repository manages and syncs the author's (seekerkrt) dotfiles. It includes GNU Stow deployment, custom systemd unit / drop-in installation, Secure Boot maintenance scripts, and package-list backups.
This repository is primarily hosted on GitHub, and the same-named repository on GitLab serves as a backup mirror. GitHub is the primary upstream for updates. Additionally, sensitive information such as private keys and tokens is excluded from this repository.
.
├── stow/ # User config deployed by GNU Stow
│ ├── alacritty/ # Alacritty config
│ ├── antigravity/ # Antigravity IDE config
│ ├── bash/ # Bash config
│ ├── btop/ # btop config
│ ├── cargo/ # Cargo config
│ ├── ccache/ # ccache config
│ ├── chrome/ # Chrome config
│ ├── clang-format/ # clang-format config
│ ├── claude/ # Claude Code config (see: Agent Configuration)
│ ├── codex/ # Codex config (see: Agent Configuration)
│ ├── conky/ # Conky config
│ ├── emacs/ # Emacs config
│ ├── env/ # Environment variables config
│ ├── fonts/ # Fonts config
│ ├── foot/ # foot terminal config
│ ├── gemini/ # Antigravity CLI config (see: Agent Configuration)
│ ├── git/ # Git config
│ ├── grok/ # Grok config (see: Agent Configuration)
│ ├── hypr/ # Hyprland config
│ ├── kde/ # KDE config
│ ├── mako/ # mako notification daemon config
│ ├── markdownlint/ # markdownlint config
│ ├── npm/ # npm config
│ ├── nvim/ # Neovim config
│ ├── scripts/ # Local scripts
│ ├── sway/ # Sway config
│ ├── tmux/ # tmux config
│ ├── tmuxp/ # tmuxp config
│ ├── vim/ # Vim config
│ ├── vscode/ # VS Code config
│ ├── waybar/ # Waybar config
│ ├── wezterm/ # WezTerm config
│ ├── xorg/ # X.Org config
│ ├── yazi/ # yazi terminal file manager config
│ ├── zsh/ # Zsh config
│ └── zsh-functions/ # Zsh functions
├── systemd/ # Custom systemd units / drop-ins (not Stow-managed)
│ ├── system/ # deployed to /etc/systemd/system/
│ │ └── clamav-clamonacc.service.d/
│ │ └── override.conf
│ └── user/ # deployed to ~/.config/systemd/user/
│ └── ssh-agent.service
├── system/secureboot/ # Secure Boot config and scripts
├── pkglist/ # Explicit package lists
├── sample/ # System configuration samples
├── docs/ # Supplementary documentation
│ └── AI-CODINGAGENTS-INSTALLATIONS.md # AI CLI install paths and updates
├── apply-stow.sh # Create Stow links
├── remove-stow.sh # Remove Stow links
├── setup-systemd-services.sh # Install systemd units and enable state
├── update-pkglist.sh # Update package lists
├── restore-pkglist.sh # Restore packages from lists
├── backup-ssh-allowlist.sh # Back up SSH keys and config with GPG
├── restore-ssh-allowlist.sh # Restore SSH keys and config from GPG
├── backup-ssh-config.sh # Back up only SSH config with GPG
├── restore-ssh-config.sh # Restore only SSH config from GPG
└── setup-system.sh # Install system-side config
Important
stow/codex/.codex/AGENTS.md is the single source of truth for the shared contract.
CLAUDE.md imports the Codex source via @~/.codex/AGENTS.md, and
GEMINI.md is a one-way port of it. Both carry only agent-specific
deltas. Always edit the Codex source first when changing a shared rule.
Each agent reads the following files, backed by this repository:
| Agent | Source in this repo | Resolved path | Contents |
|---|---|---|---|
| Codex | stow/codex/.codex/AGENTS.md |
~/.codex/AGENTS.md |
Canonical shared contract |
| Codex | stow/codex/.agents/skills/ |
~/.agents/skills/ |
9 skills |
| Codex | stow/codex/.codex/*.config.toml |
~/.codex/ |
Per-model profiles |
| Claude Code | stow/claude/.claude/CLAUDE.md |
~/.claude/CLAUDE.md |
Imports the Codex source + deltas |
| Claude Code | stow/claude/.claude/skills/ |
~/.claude/skills/ |
9 skills |
| Claude Code | stow/claude/.claude/settings.json |
~/.claude/settings.json |
Permissions, model, plugins |
| Antigravity CLI | stow/gemini/.gemini/GEMINI.md |
~/.gemini/GEMINI.md |
Port of the Codex source |
| Antigravity CLI | stow/gemini/.gemini/antigravity-cli/skills/ |
~/.gemini/antigravity-cli/skills/ |
9 skills |
| Grok | stow/grok/.grok/config.toml |
~/.grok/config.toml |
CLI, UI, and marketplace settings |
Codex, Claude Code, and Antigravity CLI carry the same nine skills:
audit commit-prep cpp-conventions github
handoff handoff-inline handoff-archive issue-slice verify
Note
On Claude Code the skill is named verify-diff, not verify.
It is renamed deliberately because verify collides with a built-in command.
The contract itself matches the other agents' verify.
issue-slice is the orchestrator for a GitHub Issue or an explicitly selected
PR-sized implementation slice. It fixes scope and non-scope, routes to the
existing audit, cpp-conventions, verify (verify-diff on Claude Code),
commit-prep, github, and handoff skills when needed, performs the minimum
implementation and verification, and stops before commit.
Long test, build, release-check, compiler, runtime, and diff logs are kept
outside the repository under ~/handoff/<repo>/<scope>/ with timestamped
filenames. Final responses report pass / fail, the saved path, and key points
instead of embedding raw logs.
The three handoff skills (handoff / handoff-inline / handoff-archive)
are kept body-identical across all three agents, front matter excluded.
The only permitted per-agent delta is the parent-skill reference path in
handoff-inline.
Warning
~/.gemini is symlinked as a whole directory.
As a result, Antigravity CLI runtime data (history.jsonl, log/,
conversations/, brain/, ...) is written inside this repository.
Those paths are excluded via .gitignore; only GEMINI.md,
settings.json and skills/ are tracked.
Codex and Claude Code symlink individual files and directories, so they
are not affected.
Grok is also a file-level symlink of config.toml only.
~/.grok remains a real directory. This repository does not keep a
copy of the shared contract or the nine skills under stow/grok.
Runtime data such as auth.json, sessions/, and logs/ stays in
the home directory and is not tracked.
docs/AI-CODINGAGENTS-INSTALLATIONS.md is the source of truth for how each
CLI is installed, where it currently lives, and how it is updated.
| CLI | Install path | Command |
|---|---|---|
| Codex | npm global | codex |
| Claude Code | Official native installer | claude |
| Grok | npm global | grok |
| Antigravity CLI | Official installer + wrapper in this repo | agy |
stow/scripts/.local/bin/update-ai-cli.sh updates all four at once. After Stow
deployment it is available as ~/.local/bin/update-ai-cli.sh.
update-ai-cli.shFor each CLI it prints the resolved path and the version before and after, then
runs <command> update in the order codex → claude → grok → agy.
A CLI missing from PATH is skipped without aborting the run; the script exits
with 1 if any update failed.
On a fresh Arch install, run the scripts in this order, matching their respective responsibilities:
- Restore packages:
./restore-pkglist.sh - Deploy $HOME config:
./apply-stow.sh - Install system-side (Secure Boot) config:
sudo ./setup-system.sh - Install systemd units / drop-ins and enable them:
./setup-systemd-services.sh --apply - Restore SSH config if needed:
./restore-ssh-config.sh BACKUP_DIR(or./restore-ssh-allowlist.sh BACKUP_DIRto include the keys)
There is no single all-in-one bootstrap script; run the steps individually.
Creates symlinks from the stow/ directory to your $HOME.
./apply-stow.sh(The vscode package and the .codex subtree of the codex package use
--no-folding. Codex Skills are deployed as directory symlinks at
~/.agents/skills/<skill>.)
Important
systemd units, drop-ins, and enable state are out of Stow's scope.
They are owned by systemd/ and setup-systemd-services.sh.
apply-stow.sh and remove-stow.sh list the former package name
systemd-user in SKIP_PACKAGES. The package itself is already deleted;
the entry remains as a guard against accidentally putting systemd back
under Stow, because a Stow symlink at the same path would conflict with
the real files installed by the setup script.
Track and sync installed packages across installations. ・To Save Current Packages:
./update-pkglist.sh・To Restore Packages:
./restore-pkglist.sh（Automatically detects yay or paru for foreign/AUR packages and applies --needed）
Securely backs up critical SSH files (including private keys) into a
GPG-encrypted archive stored in a user-specified external directory
(BACKUP_DIR), outside the git history. BACKUP_DIR is a required argument
for every script below; nothing is ever written inside this repository.
・Backup (only ~/.ssh/config, id_ed25519, and id_ed25519.pub;
authorized_keys, known_hosts, and known_hosts.old are excluded):
./backup-ssh-allowlist.sh /path/to/secure-backup-dir・Restore:
./restore-ssh-allowlist.sh /path/to/secure-backup-dirThe archive is BACKUP_DIR/ssh-backup.tar.gz.gpg. The backup script aborts if
BACKUP_DIR does not exist, and rotates an existing archive to a timestamped
.bak before replacing it. The restore script validates the archive against
the same allowlist and refuses to overwrite ~/.ssh if it exists and is not
empty.
Additionally, scripts to back up and restore only the ~/.ssh/config file are
available.
・Backup SSH Config only:
./backup-ssh-config.sh /linuxshare/Backup・Restore SSH Config only:
./restore-ssh-config.sh /linuxshare/Backup/linuxshare/Backup is only an example, not a fixed path. In general terms the
archive is BACKUP_DIR/ssh-config.tar.gz.gpg.
Backup behavior:
BACKUP_DIRis a required argument- The directory must already exist; the script never creates it
- Only
~/.ssh/configis included - GPG symmetric encryption (
gpg -c) is used - The output is
BACKUP_DIR/ssh-config.tar.gz.gpg
Restore behavior:
BACKUP_DIRis a required argument- Restores from
BACKUP_DIR/ssh-config.tar.gz.gpg - Only
~/.ssh/configis restored - The archive contents are validated; anything other than
.ssh/configaborts - An existing
~/.ssh/configis moved to a timestamped.bakbefore overwrite ~/.sshis set to 700 and~/.ssh/configto 600- A symlinked
~/.sshor~/.ssh/configis rejected
sudo ./setup-system.shThis deploys tools to /usr/local/sbin and handles automatic sbctl re-signing whenever grub updates via a post-transaction pacman hook. For recovery details, refer to system/secureboot/README.md.
Installs the custom units and drop-ins under systemd/ and reproduces the
persistent enable state of the explicitly managed units.
systemd units, drop-ins, and enable state are owned by systemd/ and
setup-systemd-services.sh, not by GNU Stow.
・Dry run (no arguments, the default):
./setup-systemd-services.shIt changes neither the filesystem nor any systemd state; it only reports what would happen.
・Apply:
./setup-systemd-services.sh --applyInstalls the custom units / drop-ins and reproduces the persistent enable state of the required units. The order is fixed:
install custom system / user units and drop-ins
→ daemon-reload only when unit files actually changed
→ enable system units
→ enable user units
・Start inactive units after applying:
./setup-systemd-services.sh --apply --now--now only starts units that are currently inactive; it never restarts or
stops anything.
Safety policy of the current implementation:
- Never installs packages
- Never disables units
- Never masks or unmasks units
- Never stops units
- Never restarts units
- Skips masked units for manual handling instead of changing them
- Records missing units as possibly-uninstalled packages and keeps going
- Installs only the custom units and drop-ins owned by this repository, never shadowing a package-provided unit file