An open API service indexing awesome lists of open source software.

https://github.com/bcorfman/public-dotfiles


https://github.com/bcorfman/public-dotfiles

Last synced: about 2 months ago
JSON representation

Awesome Lists containing this project

README

          

# Public Dotfiles

This is a first-class `chezmoi` source repository for the public, reproducible
parts of the WSL development environment.

Layout:

- `.chezmoi.toml.tmpl`
Bootstrap config template for `chezmoi init`.
- `dot_*`
Actual chezmoi-managed source state.
- `.chezmoiignore.tmpl`
Prevents repo-only docs and manifests from being applied into `$HOME`.
- `docs/LOCAL-SECRETS.md`
Local-only data and secrets workflow.
- `docs/VALIDATION.md`
How to validate the source state with `chezmoi`.
- `manifests/`
Restore manifests that stay in the repo but are ignored by chezmoi apply.
- `scripts/restore-public-dev-env.sh`
Base tooling bootstrap for `apt` packages, Homebrew, and the Brewfile bundle.

Deliberate exclusions:

- private credentials and secrets
- all Khoj-related config, data, and environment variables
- machine-local caches, logs, histories, and runtime state
- autogenerated files that are not useful for restore
- machine-specific launcher and trust state
- local identity values and machine-specific paths

Basic usage:

```bash
git clone https://github.com/bcorfman/public-dotfiles.git ~/src/public-dotfiles
~/src/public-dotfiles/scripts/restore-public-dev-env.sh
chezmoi init https://github.com/bcorfman/public-dotfiles.git
chezmoi apply
```

## WSL Git Credential Manager

This source state is designed to restore Git-on-WSL using Windows Git
Credential Manager, not SSH-agent-based Git auth.

On newer Ubuntu WSL releases such as 26.04 `resolute`, this repo defaults the
browser command to `xdg-open` instead of `wslview`, since `wslu` is no longer
packaged there.

For that to work after a WSL rebuild:

- Windows Git must be installed.
- The Git Credential Manager helper must exist at the path supplied through
local chezmoi machine data.
- The Windows Credential Manager entries must still exist in the Windows user
profile.

Post-restore verification:

```bash
git config --global --get credential.helper
git config --global --get credential.credentialStore
git ls-remote https://github.com/bcorfman/public-dotfiles.git
```

If `git ls-remote` succeeds without prompting for new credentials, the restored
WSL environment is correctly using Windows Git Credential Manager.