{"id":44954502,"url":"https://github.com/dmoliveira/utils-scripts","last_synced_at":"2026-03-01T10:02:27.954Z","repository":{"id":36418514,"uuid":"40723489","full_name":"dmoliveira/utils-scripts","owner":"dmoliveira","description":"Fast, reproducible setup for AI/ML engineers using zsh, tmux, starship, neovim and Python.","archived":false,"fork":false,"pushed_at":"2026-02-18T12:23:19.000Z","size":451,"stargazers_count":0,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-02-18T13:59:37.363Z","etag":null,"topics":["ai","debian","developer-setup","machine-learning","macos","neovim","python","startship","tmux","zsh"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dmoliveira.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2015-08-14T15:56:46.000Z","updated_at":"2026-02-18T12:23:23.000Z","dependencies_parsed_at":"2022-09-11T20:20:56.026Z","dependency_job_id":null,"html_url":"https://github.com/dmoliveira/utils-scripts","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/dmoliveira/utils-scripts","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmoliveira%2Futils-scripts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmoliveira%2Futils-scripts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmoliveira%2Futils-scripts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmoliveira%2Futils-scripts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dmoliveira","download_url":"https://codeload.github.com/dmoliveira/utils-scripts/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmoliveira%2Futils-scripts/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29966684,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T09:33:09.965Z","status":"ssl_error","status_checked_at":"2026-03-01T09:25:48.915Z","response_time":124,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5: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":["ai","debian","developer-setup","machine-learning","macos","neovim","python","startship","tmux","zsh"],"created_at":"2026-02-18T11:19:00.461Z","updated_at":"2026-03-01T10:02:27.940Z","avatar_url":"https://github.com/dmoliveira.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# utils-scripts\n\n![utils-scripts hero image generated from a GPT-Image-1 prompt](docs/assets/hero-gpt-image-1.svg)\n\n\u003e A practical setup kit for terminal-first engineering: bootstrap faster, ship cleaner, and keep your daily workflow predictable.\n\n[![License: GPL-2.0](https://img.shields.io/badge/License-GPL--2.0-blue.svg)](LICENSE)\n[![Platform](https://img.shields.io/badge/Platform-Debian%20%7C%20macOS-lightgrey.svg)](#supported-platforms)\n[![Donate via Stripe](https://img.shields.io/badge/Donate-Stripe-blue?logo=stripe\u0026logoColor=white)](https://buy.stripe.com/8x200i8bSgVe3Vl3g8bfO00)\n\n## Why this exists\n\nI rebuild environments often for delivery, demos, mentoring, and incident response.\nThis repository keeps that setup intentional and repeatable so you can:\n\n- get to a working shell stack quickly (`zsh`, `starship`, `tmux`, `nvim`)\n- use practical defaults for AI/ML-heavy work\n- verify your machine setup before you lose time to edge-case breakages\n- move from \"new user\" to \"power user\" with opinionated playbooks\n\nIf this project saves you setup time, your donation directly funds ongoing maintenance and docs updates.\n\n## Docs Hub\n\n- GitHub Pages docs: `docs/index.md` (published site)\n- Wiki source for GitHub Wiki: `wiki/Home.md`\n- Wiki mirror payload builder: `scripts/build_wiki_payload.sh`\n- Workflow matrix: `docs/workflow-matrix.md`\n- Quick command cards: `docs/top-10-new-user-commands.md`\n- Terminal scenario playbook: `TERMINAL_PLAYBOOK.md`\n- Power-user cheatsheets index: `docs/cheatsheets/index.md`\n\nSpecial progress keyword for ongoing work across docs and release notes:\n\n`CONTINUE_TAG: #continue-utils`\n\n## Quick start\n\n```bash\ngit clone https://github.com/dmoliveira/utils-scripts.git\ncd utils-scripts\nmake help\nmake install-mac    # or: make install-debian / make install-unix\nmake verify\n```\n\nFirst five minutes after install:\n\n```bash\nexec zsh\nmake verify\nmake hooks-install\nmake pre-commit-install\nmake git-delta-config\nmake docs-browse\n```\n\n## Who should read what\n\n### New users\n\n1. `docs/getting-started.md`\n2. `README.md` (this file)\n3. `TERMINAL_PLAYBOOK.md`\n4. `docs/top-10-new-user-commands.md`\n\n### Power users\n\n1. `docs/power-user.md`\n2. `docs/cheatsheets/index.md`\n3. `docs/troubleshooting.md`\n4. `docs/top-10-power-user-commands.md`\n5. `docs/top-10-release-maintainer-commands.md`\n\n## What is included\n\n| File | Purpose |\n| --- | --- |\n| `install_my_programs_debian` | Debian/Ubuntu installer |\n| `install_my_programs_mac` | macOS installer (Homebrew based) |\n| `install_my_programs_unix` | Generic Unix installer |\n| `verify_post_install_unix` | Smoke checks after install |\n| `doctor_post_install_unix` | Strict checks with fix hints |\n| `verify_linux_edge_cases` | Linux command-variant checks |\n| `bootstrap_shell_secrets` | Interactive shell secrets setup |\n| `rollback_installer_backups` | Restore latest installer backups |\n| `configure_git_delta` | Configure global git delta UX |\n| `install_git_hooks` | Install local hooks |\n| `run_commands/` | Shell/editor templates and helper functions |\n| `docs/cheatsheets/*.md` | Command-by-command practical references |\n| `.github/workflows/*` | CI checks + release/docs publishing workflows |\n\n## Supported platforms\n\n- Debian and Ubuntu\n- macOS\n- Other Unix flavors are best-effort\n\n## Core commands\n\n```bash\nmake verify\nmake verify-strict\nmake doctor\nmake doctor-full\nmake verify-linux\nmake docs-browse\nmake wiki-build\nmake wiki-build-check\nmake rollback-dry-run\nmake rollback\n```\n\n## Features by workflow stage\n\n### Bootstrap\n\n- installs terminal, editor, and productivity tooling\n- applies baseline shell config templates with backups\n- supports dry runs for low-risk previews\n\n### Validate\n\n- verifies required commands and expected config files\n- checks shell/tmux/nvim startup integrity\n- supports strict and JSON output modes for CI and automation\n\n### Operate\n\n- provides leader-pack shortcuts in `run_commands/my_zshrc`\n- includes scenario-first playbooks in `TERMINAL_PLAYBOOK.md`\n- includes per-tool cheatsheets for fast command recall\n\n### Maintain\n\n- lint and smoke workflows in GitHub Actions\n- release-on-tag automation via `.github/workflows/release-on-tag.yml`\n- docs publication workflow for Pages and Wiki\n\n## Configuration references\n\n- Zsh template: `run_commands/my_zshrc`\n- Tmux template: `run_commands/my_tmux.conf`\n- Starship template: `run_commands/my_starship.toml`\n- Neovim template: `run_commands/my_nvim_init.lua`\n- Ghostty template: `run_commands/my_ghostty_config`\n- WezTerm template: `run_commands/my_wezterm.lua`\n\n## Troubleshooting quick picks\n\n- if `verify_post_install_unix` fails in strict mode, run `make doctor`\n- if command variants differ on Linux (`fd` vs `fdfind`, `bat` vs `batcat`), run `make verify-linux`\n- if shell secrets are not loaded, run `make bootstrap-secrets` and ensure `chmod 600 ~/.config/secrets/shell.env`\n- if you need rollback, run `make rollback-dry-run` first\n- if `make shell-lint` fails with `mapfile: command not found`, update to latest release\n\nFull troubleshooting guide: `docs/troubleshooting.md`\n\n## Releases\n\nTags matching `v*` trigger `.github/workflows/release-on-tag.yml`.\n\n```bash\ngit tag v1.2.0\ngit push origin v1.2.0\n```\n\nThe release template is in `.github/RELEASE_NOTES_TEMPLATE.md`.\n\n## Contributing\n\n1. Fork the repo\n2. Create a branch\n3. Keep changes scoped and tested\n4. Open a PR\n\nPlease keep scripts portable and avoid unnecessary dependencies.\n\n## Support and connect\n\nIf this repo made your setup calmer, faster, or easier to maintain, consider donating:\n\n[![Donate via Stripe](https://img.shields.io/badge/Donate-Stripe-blue?logo=stripe\u0026logoColor=white)](https://buy.stripe.com/8x200i8bSgVe3Vl3g8bfO00)\n\nImpact breakdown: `docs/donation-impact.md`\n\nYou can also connect here:\n\n- CV: [dmoliveira.github.io/my-cv-public](https://dmoliveira.github.io/my-cv-public/)\n- LinkedIn: [linkedin.com/in/dmztheone](https://www.linkedin.com/in/dmztheone/)\n\n## License\n\nThis project is licensed under the GNU GPL-2.0 license.\n\nAuthor: [Diego Marinho](https://github.com/dmoliveira)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdmoliveira%2Futils-scripts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdmoliveira%2Futils-scripts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdmoliveira%2Futils-scripts/lists"}