{"id":20162594,"url":"https://github.com/zdharma-continuum/zsh-unique-id","last_synced_at":"2025-06-12T12:38:50.014Z","repository":{"id":103427581,"uuid":"423688765","full_name":"zdharma-continuum/zsh-unique-id","owner":"zdharma-continuum","description":null,"archived":false,"fork":false,"pushed_at":"2023-04-16T05:39:25.000Z","size":31,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-08T00:09:22.097Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C","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/zdharma-continuum.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":"2021-11-02T02:59:45.000Z","updated_at":"2021-11-12T17:48:39.000Z","dependencies_parsed_at":null,"dependency_job_id":"45a08c6a-7cdb-448c-b189-a468315b07af","html_url":"https://github.com/zdharma-continuum/zsh-unique-id","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zdharma-continuum/zsh-unique-id","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zdharma-continuum%2Fzsh-unique-id","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zdharma-continuum%2Fzsh-unique-id/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zdharma-continuum%2Fzsh-unique-id/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zdharma-continuum%2Fzsh-unique-id/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zdharma-continuum","download_url":"https://codeload.github.com/zdharma-continuum/zsh-unique-id/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zdharma-continuum%2Fzsh-unique-id/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259466695,"owners_count":22862367,"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":[],"created_at":"2024-11-14T00:25:51.102Z","updated_at":"2025-06-12T12:38:49.986Z","avatar_url":"https://github.com/zdharma-continuum.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# zsh-unique-id\n\n#### Commit count\n\nDon't worry about **low commit count**, this project is a derivative of\n[zdharma-continuum/zconvey](https://github.com/zdharma-continuum/zconvey), which has ~190 commits and has been\nmaintained and used for 1.5 years now.\n\n### Introduction\n\nThis plugin provides a **unique number** that identifies a **running** Zshell session, in its shell variable `$ZUID_ID`.\nBesides this unique number, also a unique *codename* is provided, in shell variable `$ZUID_CODENAME`. Once you load this\nplugin, the two parameters will be set, and their values will not be available to other Zshell sessions (being thus\n*unique*).\n\n`$ZUID_ID` is a progressing number starting from `1`. `$ZUID_CODENAME` is chosen from a list of predefined codenames,\nsee the default list below.\n\nAn example use case is to hold logs in files `.../mylog-${ZUID_CODENAME}.log`, so that two different Zshells will not\nwrite to the same file at the same time.\n\nDefault codenames are:\n\n- atlantis (for `ZUID_ID` == `1`)\n- echelon (for `ZUID_ID` == `2`)\n- quantum (etc.)\n- ion\n- proxima\n- polaris\n- solar\n- momentum\n- hyper\n- gloom\n- velocity\n- future\n- enigma\n- andromeda\n- saturn\n- jupiter\n- aslan\n- commodore\n- falcon\n- persepolis\n- dharma\n- samsara\n- prodigy\n- ethereal\n- epiphany\n- aurora\n- oblivion\n\nZstyle configuration allows to customize the codenames:\n\n```zsh\nzstyle :plugin:zuid codenames paper metal wood plastic # first 4 shells will have those codenames\n```\n\n# Installation\n\n**The plugin is \"standalone\"**, which means that only sourcing it is needed (without using a plugin manager). So to\ninstall, unpack `zsh-unique-id` somewhere and add:\n\n```zsh\nsource {where-zsh-unique-id-is}/zsh-unique-id.plugin.zsh\n```\n\nto `zshrc`.\n\nSourcing is recommended, because it can be done early, at top of zshrc, without a plugin manager – to acquire the unique\nidentification as early as possible.\n\n## [Zinit](https://github.com/zdharma-continuum/zinit)\n\nAdd `zinit load zdharma-continuum/zsh-unique-id` to your `.zshrc` file. Zinit will clone the plugin the next time you\nstart zsh. To update issue `zinit update zdharma-continuum/zsh-unique-id`.\n\n## Antigen\n\nAdd `antigen bundle zdharma-continuum/zsh-unique-id` to your `.zshrc` file. Antigen will handle cloning the plugin for\nyou automatically the next time you start zsh.\n\n## Oh-My-Zsh\n\n1. `cd ~/.oh-my-zsh/custom/plugins`\n1. `git clone https://github.com/zdharma-continuum/zsh-unique-id.git`\n1. Add `zsh-unique-id` to your plugin list\n\n## Zgen\n\nAdd `zgen load zdharma-continuum/zsh-unique-id` to your .zshrc file in the same place you're doing your other\n`zgen load` calls in.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzdharma-continuum%2Fzsh-unique-id","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzdharma-continuum%2Fzsh-unique-id","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzdharma-continuum%2Fzsh-unique-id/lists"}