{"id":19658589,"url":"https://github.com/alexis-moins/dot","last_synced_at":"2026-02-14T18:31:51.341Z","repository":{"id":239335364,"uuid":"797298441","full_name":"alexis-moins/dot","owner":"alexis-moins","description":"Dotfiles manager 🍜","archived":false,"fork":false,"pushed_at":"2024-07-16T20:06:38.000Z","size":74,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-19T17:53:21.431Z","etag":null,"topics":["bash","cli","dotfiles","gum","stow"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alexis-moins.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2024-05-07T15:13:27.000Z","updated_at":"2024-07-16T20:06:44.000Z","dependencies_parsed_at":"2024-05-31T20:14:24.553Z","dependency_job_id":"02ff10b6-d0e6-4368-8dbf-0a01e53ff400","html_url":"https://github.com/alexis-moins/dot","commit_stats":null,"previous_names":["alexis-moins/dot"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/alexis-moins/dot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexis-moins%2Fdot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexis-moins%2Fdot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexis-moins%2Fdot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexis-moins%2Fdot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alexis-moins","download_url":"https://codeload.github.com/alexis-moins/dot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexis-moins%2Fdot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29452371,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-14T15:52:44.973Z","status":"ssl_error","status_checked_at":"2026-02-14T15:52:11.208Z","response_time":53,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["bash","cli","dotfiles","gum","stow"],"created_at":"2024-11-11T15:38:12.877Z","updated_at":"2026-02-14T18:31:51.316Z","avatar_url":"https://github.com/alexis-moins.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align='center'\u003e\n\n![Version](https://img.shields.io/badge/version-1.2.0-blue.svg)\n\n\u003c/div\u003e\n\n`dot` is a bash script allowing users to manage their dotfiles.\n\n## Prerequisites\n\n- bash 4.0 or higher\n- [gum](https://github.com/charmbracelet/gum)\n- stow\n- git\n\n\n## 🧰 Installation\n\n### Using dot\n\nClone the repository in the recommended location\n```bash\ngit clone git@github.com:alexis-moins/dot.git ~/.dot\n```\n\nGo into the install directory and execute the [install](install) script:\n```bash\n./install\n```\n\nThe last command creates a symbolic link to the `dot` script in the `~/.local/bin/` directory (you can also change the link destination path by passing it as an argument to the install script).\n\n\u003e If you did not clone the repository in `~/.dot`, don't forget to set the `DOT_INSTALL_DIR` environment variable globally afterwards!\n\n### Manually\n\nClone the repository then move the [dot](dot) script to anywhere in your `PATH`, and ensure it is executable!\n\n## 🌱 Quick Start\n\nAfter installing, you can follow these steps to quickly see how it works:\n\n```bash\n# Initialize an empty dotfiles repo\ndot init\n\n# Or clone your dotfiles\ndot init git@github.com:alexis-moins/dotfiles.git\n\n# Add a new config file to your dotfiles\ndot add ~/.bashrc\n\n# Ensure the file was added\ndot status\n\n# Show git diff\ndot diff .bashrc\n\n# Remove the original file\nrm ~/.bashrc\n\n# Create symlinks to your dotfiles in $HOME\ndot install\n\n# Stage one or more files\ndot stage .bashrc\n\n# Save your changes...\ndot commit \"feat: add .bashrc\"\n\n# ...and push them to your remote!\ndot git push\n```\n\n## 🚦 Usage\n\n```\n$ dot\n\ndot - dotfiles manager\n\nUsage:\n  dot COMMAND\n  dot [COMMAND] --help | -h\n  dot --version | -v\n\nCommands:\n  help        Show help about a command\n  link        Create a link to the dot script\n  unlink      Remove the link to the dot script\n  update      Update dot to the latest version\n  env         Show environment information\n  dir         Show dotfiles directory\n\nDotfiles Commands:\n  init        Initialize a dotfiles repository or clone one\n  edit        Edit your dotfiles\n  install     Install dotfiles using symbolic links\n  uninstall   Remove symbolic links from /Users/alexis\n  list        List files from your dotfiles\n  filter      Filter files from your dotfiles\n  cd          Navigate to your dotfiles in a new shell\n  add         Add files to your dotfiles\n\nGit Commands:\n  status      Show the status of your dotfiles\n  stage       Stage files\n  unstage     Unstage files\n  restore     Restore unstaged files (undo changes)\n  diff        Show interactive diff with last commit\n  commit      Commit changes\n  git         Run git commands within your dotfiles\n\nOptions:\n  --help, -h\n    Show this help\n\n  --version, -v\n    Show version number\n\nEnvironment Variables:\n  EDITOR\n    Editor to use for interactive commands\n    Default: vim\n\n  DOT_INSTALL_DIR\n    Directory where the repository was cloned\n    Default: ~/.dot\n\n  DOTFILES_DIR\n    Directory containing your dotfiles\n    Default: ~/dotfiles\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexis-moins%2Fdot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexis-moins%2Fdot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexis-moins%2Fdot/lists"}