{"id":49727548,"url":"https://github.com/alycda/dotfiles","last_synced_at":"2026-05-09T05:14:35.216Z","repository":{"id":331422645,"uuid":"1125610985","full_name":"alycda/dotfiles","owner":"alycda","description":"This repo documents my journey learning Nix—starting from zero","archived":false,"fork":false,"pushed_at":"2026-05-08T05:04:00.000Z","size":224,"stargazers_count":1,"open_issues_count":13,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-08T07:15:43.513Z","etag":null,"topics":["cheatsheet","claude-code","dotfiles","helix","home-manager","jujutsu","nix","nix-darwin","nix-lang"],"latest_commit_sha":null,"homepage":"","language":"Nix","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alycda.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-31T03:22:36.000Z","updated_at":"2026-05-08T05:04:03.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/alycda/dotfiles","commit_stats":null,"previous_names":["alycda/dotfiles"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/alycda/dotfiles","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alycda%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alycda%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alycda%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alycda%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alycda","download_url":"https://codeload.github.com/alycda/dotfiles/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alycda%2Fdotfiles/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32807957,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T08:22:46.396Z","status":"online","status_checked_at":"2026-05-09T02:00:06.633Z","response_time":123,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cheatsheet","claude-code","dotfiles","helix","home-manager","jujutsu","nix","nix-darwin","nix-lang"],"created_at":"2026-05-09T05:14:34.569Z","updated_at":"2026-05-09T05:14:35.204Z","avatar_url":"https://github.com/alycda.png","language":"Nix","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Alyssa's dotfiles\n\nThese are my dotfiles, managed by [Nix](https://nixos.org/), [Nix-Darwin](https://nix-darwin.org) and [Home Manager](https://github.com/nix-community/home-manager) (via [flakes](https://nixos.wiki/wiki/Flakes)).\n\n```\ndotfiles/\n├── darwin/\n|   ├── profiles/\n|   |   ├── alyssa.nix\n|   |   └── ditto.nix\n|   └── configuration.nix\n├── home-manager/\n|   ├── modules/\n|   |   ├── ide/vscode  # extensions \u0026 settings\n|   |   └── common.nix\n|   └── profiles/\n|       ├── dev.nix     # for devcontainers\n|       ├── home.nix\n|       └── work.nix\n├── .devcontainer.json  # Nix Package Manager\n├── .gitignore          # Nix artifacts\n├── flake.lock\n├── flake.nix           # Home Manager config\n├── justfile            # Task Runner recipes\n└── README.md           \n```\n\n### Quickstart\n[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/alycda/dotfiles)\n\n## What is Nix?\n\nNix is three things:\n\n| Thing | What it is | You might use it to... |\n|-------|-----------|------------------------|\n| **Nix** (language) | A purely functional [language](https://nixos.org/manual/nix/stable/language/) for defining packages and configurations | Write `.nix` files |\n| **Nix** (package manager) | A [package manager](https://nixos.org/manual/nixpkgs/stable/) that installs packages in isolation. Like [homebrew](https://brew.sh/). | `nix profile install nixpkgs#ripgrep` |\n| **NixOS** (os) | A Linux [distro](https://nixos.org/manual/nixos/stable/) configured entirely by Nix files | Run a fully reproducible system |\n\nYou don't need all three. This repo leverages Home Manager with flakes in a [devcontainer](https://containers.dev/) (lightweight Debian with Nix Package Manager).\n\n\n## Getting started\n\nYou need ONE of these:\n\n| Option | What you need | Good for |\n|--------|--------------|----------|\n| **Devcontainer** | Docker + VSCode with [Remote Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) | Exploring without installing Nix locally |\n| **[GitHub Codespaces](https://github.com/features/codespaces/)** | A GitHub account | Exploring in the cloud |\n| **Local Nix** | [Nix installed](https://nixos.org/download) | Already have Nix or want to install it |\n\n### macOS setup (Darwin)\n\n`nix-darwin` manages macOS system configuration declaratively, including dock apps, system defaults (defaults write) and Homebrew packages.\n\n1. [Install Nix](https://nixos.org/download)\n1. Bootstrap `nix-darwin` (once)\n    - `nix run nix-darwin -- switch --flake .ditto` (work)\n1. Rebuild after changes\n    - `just _rebuild alyssa@work`\n\n### Devcontainer (Linux sandboxed environment)\n\n\u003e ! does not support nix-darwin\n\n1. Clone this repo\n    - `gh repo clone alycda/dotfiles`\n1. Open in VSCode\n    - `ms-vscode-remote.remote-containers`\n1. Click \"Reopen in Container\" when prompted\n    - or \u003ckbd\u003eCMD\u003c/kbd\u003e+\u003ckbd\u003eSHIFT\u003c/kbd\u003e+\u003ckbd\u003eP\u003c/kbd\u003e \u003e **Dev Containers**\n1. You now have `nix` available:\n    - `nix-env`\n    - `nix profile`\n    - [nix-shell](https://nix.dev/tutorials/first-steps/declarative-shell.html)\n1. Bootstrap Home Manager (once)\n    - `nix run home-manager/master -- switch --flake .#alyssa@dev`\n1. You now have `gh`, `hx`, `jj` and `just` available:\n    - [github cli](https://cli.github.com/manual/)\n    - What is [jujutsu](https://kubamartin.com/posts/introduction-to-the-jujutsu-vcs/)?\n    - rebuild with `just` or `just _rebuild`\n\n### Other (Flake) devShell (without Home Manager)\n\n- `nix develop github:alycda/dotfiles` or\n- `nix develop github:alycda/dotfiles#tools`\n  + `-c cheat -l` immediately run a command AND EXIT\n\n## Why a devcontainer?\n\nAs long as you have docker or an [ephemeral environment in the cloud](https://ephemeralenvironments.io/), you can explore my setup without polluting your system.\n\n\n## How it works\n\n### Structure\n\n| Directory | Tool | Purpose |\n|-----------|------|---------|\n| `darwin/` | nix-darwin | macOS system config (dock, defaults, homebrew)\n| `home-manager/` | Home Manager | User packages and dotfiles (cross-platform)\n\nThis keeps package management declarative and reproducible across environments.\n\n---\n\n#### /etc/nix/nix.conf (without nix-darwin)\n\n```nix\nallowed-users = @nix-users\nbuild-users-group = nixbld\n\nextra-experimental-features = nix-command flakes\n```\n\n### Resources\n\n- [Zero to Nix](https://zero-to-nix.com/)\n- [Nix Pills](https://nixos.org/guides/nix-pills/) — Deep dive (dense but thorough)\n- [home-manager](https://github.com/nix-community/home-manager) — Manage dotfiles with Nix\n- [hame-manager Option Search](https://home-manager-options.extranix.com/)\n- [nix-darwin](https://nix-darwin.org)\n- [devcontainers](https://containers.dev/) — Container-based dev environments\n- [Orbstack](https://orbstack.dev/) — Fast Docker alternative for macOS\n- [gh repo clone](https://cli.github.com/manual/gh_repo_clone)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falycda%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falycda%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falycda%2Fdotfiles/lists"}