{
  "markdown": "# dotfiles\n\nCross-platform Bash dotfiles for macOS and Linux.\n\n## Install\n\nPreview first:\n\n```bash\n./bootstrap.sh --dry-run\n```\n\nInstall:\n\n```bash\n./bootstrap.sh\n```\n\nForce replacement of existing targets only when you intend to overwrite them:\n\n```bash\n./bootstrap.sh --force\n```\n\n`--force` backs up existing targets before replacing them.\n\n## Model\n\nBootstrap uses the current OS automatically:\n\n- `Darwin` -> macOS\n- `Linux` -> Linux\n\nYou normally do not need to pass a platform flag.\n\nThe shell runtime is built from:\n\n1. shared shell files from `shell/`\n2. platform overlays from `platform/macos/` or `platform/linux/`\n3. copied local/private files in your home directory\n4. prompt loaded last\n\n## Symlinked files\n\nStable shared files are symlinked into `$HOME`:\n\n- `~/.bashrc` -> `shell/bashrc`\n- `~/.bash_profile` -> `shell/bash_profile`\n- `~/.bash_prompt` -> `shell/bash_prompt`\n- `~/.aliases` -> `shell/aliases`\n- `~/.functions` -> `shell/functions`\n- `~/.exports` -> `shell/exports`\n- `~/.curlrc` -> `shell/curlrc`\n- `~/.wgetrc` -> `shell/wgetrc`\n- `~/.fonts` -> `.fonts`\n\nOn macOS, bootstrap also symlinks:\n\n- `~/.hushlogin` -> `platform/macos/hushlogin`\n- `~/.screenrc` -> `platform/macos/screenrc`\n\nIf a target already exists, bootstrap skips it unless `--force` is used.\n\n## Copied local/private files\n\nMachine-local files are copied only when missing:\n\n- `~/.path`\n- `~/.extra`\n- `~/.gitconfig`\n\nSources are selected as follows:\n\n- `~/.path`: platform-specific `platform/<os>/path.sample`, falling back to `shell/path.sample`\n- `~/.extra`: `shell/extra.sample`\n- `~/.gitconfig`: `samples/gitconfig`\n\nThese files are intentionally copied, not symlinked, so each machine can edit them locally.\n\n## Dangerous helpers\n\nDestructive helpers are not loaded by default. They live in `shell/dangerous`.\n\nOpt in by setting:\n\n```bash\nexport DOTFILES_ENABLE_DANGEROUS=1\n```\n\nor by creating a private `~/.dotfiles_dangerous` file.\n\n## Provisioning\n\nProvisioning scripts are manual and are not run by bootstrap:\n\n- `provisioning/macos/`\n- `provisioning/linux/`\n\nReview scripts before running them. Some require sudo or mutate system settings.\n\n## Host-specific examples\n\nMachine-specific examples live under `hosts/examples/`, including netplan configs. Do not apply them blindly to another host.\n",
  "bytes": 2298,
  "sha": "ddaba50180e2551128cd796f953b4d85d5f46b0b56315e6bf41b653e45ed56ad",
  "repo_slug": "hatemjaber/dotfiles",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_hatemjaber_dotfiles_luam_index_md_a8d1f1b8/readme"
}