{"id":14069516,"url":"https://github.com/belak/zsh-utils","last_synced_at":"2025-03-17T14:12:36.386Z","repository":{"id":51087221,"uuid":"128132796","full_name":"belak/zsh-utils","owner":"belak","description":"A minimal, opinionated set of ZSH plugins designed to be small, simple, and focused.","archived":false,"fork":false,"pushed_at":"2024-07-23T17:01:02.000Z","size":36,"stargazers_count":162,"open_issues_count":2,"forks_count":12,"subscribers_count":7,"default_branch":"main","last_synced_at":"2024-10-19T05:50:47.812Z","etag":null,"topics":["zsh","zsh-utils"],"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/belak.png","metadata":{"files":{"readme":"README.md","changelog":"history/history.plugin.zsh","contributing":"CONTRIBUTING.md","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":"2018-04-04T23:07:08.000Z","updated_at":"2024-10-08T09:12:31.000Z","dependencies_parsed_at":"2024-10-25T18:29:53.047Z","dependency_job_id":"b6161789-29e5-4b02-8e75-ba0e284bcb62","html_url":"https://github.com/belak/zsh-utils","commit_stats":{"total_commits":44,"total_committers":8,"mean_commits":5.5,"dds":"0.38636363636363635","last_synced_commit":"0e3238b6462fd5cd7c4c6b5d1dccbe5a69d2b5b4"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/belak%2Fzsh-utils","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/belak%2Fzsh-utils/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/belak%2Fzsh-utils/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/belak%2Fzsh-utils/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/belak","download_url":"https://codeload.github.com/belak/zsh-utils/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241935236,"owners_count":20044826,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["zsh","zsh-utils"],"created_at":"2024-08-13T07:07:00.794Z","updated_at":"2025-03-05T01:06:49.139Z","avatar_url":"https://github.com/belak.png","language":"Shell","funding_links":[],"categories":["Tutorials","Shell"],"sub_categories":["Antigen"],"readme":"# zsh-utils\n\nA minimal, opinionated set of ZSH plugins designed to be small, simple, and\nfocused.\n\nThis includes a number of simple plugins designed to smooth away some of the\nrough edges of zsh without getting in your way. The idea is that you should be\nable to say \"I'd like to enable the history features of ZSH\" (or other similar\nfeatures) without needing to know the gritty details and without worrying that\na bunch of unrelated settings will be enabled.\n\nAll the plugins are designed to work with no configuration and no additional\ndependencies, but shouldn't conflict with additional configuration you want to\ndo.\n\n## Driving Principles\n\nMany other zsh config frameworks and modules do too much, are overly complex,\ndon't work well out of the box, and have many unmaintained modules. zsh-utils\naims to be small, simple, and focused.\n\n- Don't reinvent the wheel. If there's an existing plugin elsewhere which works\n  well it should be preferred (such as [zsh-completions](https://github.com/zsh-users/zsh-completions)\n  and [zsh-syntax-highlighting](https://github.com/zsh-users/zsh-syntax-highlighting).\n- Clear is better than clever. The code should be easy to maintain for anyone\n  with a decent knowledge of zsh. Comments should be included when anything needs\n  explanation.\n- Avoid configuration when possible. Most modules should be self-contained and\n  work out of the box without any necessary configuration. These plugins make a\n  number of opinionated decisions, so some settings may be provided to disable those.\n\n## Recommended Installation\n\nOfficially [antigen][antigen] is recommended, but it should be possible to load\nwith other plugin managers like [zgen][zgen] or [zplug][zplug] as well.\n\nThe following example can be placed in your `.zshrc`. It will install antigen\nif it's missing, load antigen, install the zsh-utils repo, and load any\nspecified plugins.\n\n```sh\n[[ ! -d \"$HOME/.antigen\" ]] \u0026\u0026 git clone https://github.com/zsh-users/antigen.git \"$HOME/.antigen\"\nsource \"$HOME/.antigen/antigen.zsh\"\n\n# Set the default plugin repo to be zsh-utils\nantigen use belak/zsh-utils --branch=main\n\n# Specify completions we want before the completion module\nantigen bundle zsh-users/zsh-completions\n\n# Specify plugins we want\nantigen bundle editor@main\nantigen bundle history@main\nantigen bundle prompt@main\nantigen bundle utility@main\nantigen bundle completion@main\n\n# Specify additional external plugins we want\nantigen bundle zsh-users/zsh-syntax-highlighting\n\n# Load everything\nantigen apply\n\n# Set any settings or overrides here\nprompt belak\nbindkey -e\n```\n\n## Provided Plugins\n\n- `completion` - Load and initialize the built-in zsh completion system\n- `editor` - Override and fill in the gaps of the default keybinds\n- `history` - Load and initilize the built-in zsh history system\n- `prompt` - Load and initialize the build-in zsh prompt system\n- `utility` - Common shell utilities, aimed at making cross platform work less painful\n\n## Plugin Details\n\nFor more specific information about the plugins, check out [PLUGINS.md](./PLUGINS.md).\n\n[antigen]: https://github.com/zsh-users/antigen.git\n[xdg-basedirs]: https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html\n[zgen]: https://github.com/tarjoilija/zgen\n[zplug]: https://github.com/zplug/zplug\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbelak%2Fzsh-utils","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbelak%2Fzsh-utils","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbelak%2Fzsh-utils/lists"}