Pascal Andy's Dotfiles

My personal dotfiles managed with chezmoi.

Quick Start

Install chezmoi and apply:

chezmoi init https://github.com/pascalandy/dotfiles.git
chezmoi apply

Create ~/.config/chezmoi/chezmoi.toml with your secrets (see below).
Re-apply to inject secrets:

chezmoi apply

Secrets and Template Variables

This repo uses the keyring template function by default (see dot_config/opencode/opencode.json.tmpl and private_dot_ssh/config.tmpl). Make sure the corresponding entries exist in your system keychain.

If you prefer using chezmoi.toml data instead of keyring, replace the template lookups with .data and use this example:

[data]
# API Keys (required for opencode.json)
exa_api_key = "your-exa-api-key"
openrouter_api_key = "sk-or-v1-your-key"
context7_api_key = "your-context7-key"

# SSH Config (required for ~/.ssh/config)
ssh_host_1 = "your-server-1.example.com"
ssh_host_2 = "your-server-2.example.com"
ssh_user_2 = "your-username"

Get your API keys:

What's Included

Shell config (.zshrc, .p10k.zsh)
Git config (.gitconfig)
SSH config (templated)
VS Code settings
CLI tool configs (opencode, amp, zed)
Custom scripts in ~/.local/bin/
AI agent skills and prompts

Quality Checks

Pre-commit hooks are managed by lefthook and run gitleaks and shellcheck. Install the hooks once per machine:

lefthook install

Chezmoi Basics

Add Files

chezmoi add ~/.file
chezmoi apply
chezmoi cd && git add . && git commit -m "msg" && git push

Templates for Secrets

Files containing {{ .variable }} must have the .tmpl extension:

# Wrong - variables won't be processed
opencode.json

# Correct - chezmoi processes templates
opencode.json.tmpl

Run Scripts

run_once_* - Runs only on first apply
run_before_* - Runs before every apply
run_after_* - Runs after every apply

Crash Recovery

See crash_procedure.md for emergency recovery procedures.

Official Docs

https://www.chezmoi.io/user-guide/command-overview/

Name	convert-to-md
Description	Convert documents to Markdown. Supports specific converter selection ("convert with Mistral", "convert with markitdown", "convert with pdftotext", "convert with Docker") or automatic mode using all converters to select the best result. Use for PDF, DOCX, PPTX, XLSX, HTML, images, audio, and other file formats.

convert-to-md

SKILL.md