{"id":33014933,"url":"https://github.com/tzing/clover.zsh-theme","last_synced_at":"2025-11-25T23:30:19.411Z","repository":{"id":151192896,"uuid":"129838301","full_name":"tzing/clover.zsh-theme","owner":"tzing","description":"🍀 a configurable theme for zsh","archived":false,"fork":false,"pushed_at":"2024-06-18T15:11:08.000Z","size":331,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-06-19T18:59:10.639Z","etag":null,"topics":["zsh-theme"],"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/tzing.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}},"created_at":"2018-04-17T03:05:49.000Z","updated_at":"2024-06-18T15:11:11.000Z","dependencies_parsed_at":"2024-01-03T04:30:02.079Z","dependency_job_id":null,"html_url":"https://github.com/tzing/clover.zsh-theme","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tzing/clover.zsh-theme","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tzing%2Fclover.zsh-theme","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tzing%2Fclover.zsh-theme/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tzing%2Fclover.zsh-theme/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tzing%2Fclover.zsh-theme/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tzing","download_url":"https://codeload.github.com/tzing/clover.zsh-theme/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tzing%2Fclover.zsh-theme/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286079811,"owners_count":27282121,"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","status":"online","status_checked_at":"2025-11-25T02:00:05.816Z","response_time":54,"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":["zsh-theme"],"created_at":"2025-11-13T18:00:20.538Z","updated_at":"2025-11-25T23:30:19.406Z","avatar_url":"https://github.com/tzing.png","language":"Shell","funding_links":[],"categories":["Themes"],"sub_categories":["ZSH on Windows","Zinit (née zplugin)"],"readme":"# Clover\n\n🍀 a configurable theme for [zsh], inspired by [zeta-zsh-theme] and [pure].\n\n![screenshot](./screenshot.png)\n\n[zsh]: https://en.wikipedia.org/wiki/Z_shell\n[zeta-zsh-theme]: https://github.com/skylerlee/zeta-zsh-theme\n[pure]: https://github.com/sindresorhus/pure\n\n- Highlights environment changes\n\n  Username and host changes the style for special environments: root, remote, container\n\n- Async VCS status\n\n  Background process, don't blocks your workflow\n\n- Execution time\n\n  Show human readable execution time for long run command\n\n- Python\n\n  Virtualenv prompt is included\n\n- Show the error\n\n  Prompt indicator changes whether the last run success (🍀/🔥)\n\n- Configurable\n\n  Read the configuration section below\n\n\n## Installation\n\n### [oh-my-zsh](https://github.com/ohmyzsh/ohmyzsh)\n\nclone this repo into `$ZSH_CUSTOM`:\n\n```bash\ncd ${ZSH_CUSTOM:-\"~/.oh-my-zsh/custom\"}/themes\ngit clone git@github.com:tzing/clover.zsh-theme.git clover\n```\n\nthen change the theme:\n\n```zsh\nZSH_THEME=\"clover/clover\"\n```\n\n### [zinit](https://github.com/zdharma-continuum/zinit)\n\n```zsh\nzinit light tzing/clover.zsh-theme\n```\n\n### Manual\n\nclone this repo to somewhere you like:\n\n```sh\ngit clone git@github.com:tzing/clover.zsh-theme.git \u003cPATH\u003e\n```\n\nand source the main script in your `.zshrc`\n\n```zsh\nsource \u003cPATH\u003e/clover.zsh-theme\n```\n\n\n## Configurations\n\nThis theme reads the configurations from [`zstyle`]. All context name must be prefixed with `:prompt:clover:`. Styles are always configurable, and for some components you could also customized the symbols.\n\nHere's a disgram that shows context names:\n\n```none\n   ┌---------------------------------------------------------------------- user\n   |    ┌----------------------------------------------------------------- host\n   |    |         ┌------------------------------------------------------- path\n   |    |         |                   ┌----------------------------------- vcs:branch\n   |    |         |                   |    ┌------------------------------ vcs:status (read details below)\n   |    |         |                   |    |          ┌------------------- execution-time\n   |    |         |                   |    |          |    ┌-------------- current-time\n#  user@hostname: ~/clover.zsh-theme \u003cmain ✔⇡\u003e        10s (12:00:00 +0800)\n(.venv) 🍀\n |      └----------------------------------------------------------------- prompt\n └------------------------------------------------------------------------ virtualenv\n```\n\n[`zstyle`]: https://zsh.sourceforge.io/Doc/Release/Zsh-Modules.html#index-zstyle\n\n\u003e [!NOTE]\n\u003e\n\u003e VCS information (`:prompt:clover:vcs:*`) are evaluated in background process, which is forked in first [precmd] run.\n\u003e Runtime zstyle settings will not take effect. But you could still change the style in `.zshrc`.\n\u003e\n\u003e [precmd]: https://zsh.sourceforge.io/Doc/Release/Functions.html#index-precmd\n\n### Styles\n\nRun zstyle command with the key `style`. And the value could be the [visual effect] expresssion in zsh prompt expansion.\n\n[visual effect]: https://zsh.sourceforge.io/Doc/Release/Prompt-Expansion.html#Visual-effects\n\nAn example of setting the path to bold cyan:\n\n```bash\nzstyle :prompt:clover:path style '%B%F{cyan}'\n```\n\n### Symbols\n\nUse key `symbol` for customization.\n\nFor example, setting default prompt symbol to `$`:\n\n```bash\nzstyle :prompt:clover:prompt:default symbol '$'\n```\n\n### Contexts and default styles\n\n| context name           | usage                                         | default style                 | default symbol |\n| ---------------------- | --------------------------------------------- | ----------------------------- | -------------- |\n| `current-time`         | Current time                                  | blue                          |                |\n| `execution-time`       | Last execution time                           | 242                           |                |\n| `host:container`       | Host name when it is inside a container       | bold white text in magenta bg |                |\n| `host:default`         | Host name                                     | bold cyan                     |                |\n| `host:remote`          | Host name when it is remote session           | bold white text in blue bg    |                |\n| `path`                 | Current path                                  | bold yellow                   |                |\n| `prompt:default`       | Prompt color                                  | green                         | 🍀              |\n| `prompt:fail`          | Prompt color when last run failed             | red                           | 🔥              |\n| `user:default`         | User name                                     | bold green                    |                |\n| `user:root`            | User name when current user is `root`         | bold green                    |                |\n| `vcs:action`           | Current action in VCS                         | red                           |                |\n| `vcs:branch`           | Current branch name                           | bold blue                     |                |\n| `vcs:status:ahead`     | [Git only] Current branch is ahead of remote  | cyan                          | ⇡              |\n| `vcs:status:behind`    | [Git only] Current branch is behind of remote | magenta                       | ⇣              |\n| `vcs:status:clean`     | [Git only] Work tree is clean                 | green                         | ✔              |\n| `vcs:status:diverge`   | [Git only] Diverged changes found             | red                           | ⇕              |\n| `vcs:status:staged`    | Found staged changes in current repo          | green                         | ≡              |\n| `vcs:status:unstaged`  | Found unstaged changes in current repo        | magenta                       | ✱              |\n| `vcs:status:untracked` | [Git only] Found untracked file               | 242                           | ?              |\n| `virtualenv`           | Python [virtualenv] prompt prefix             | 242                           |                |\n\n[virtualenv]: https://virtualenv.pypa.io/en/latest/\n\n\n### Others\n\nThere are some other settings could be changed through `zstyle` too:\n\n| context name     | key                  | usage                                                            | default       |\n| ---------------- | -------------------- | ---------------------------------------------------------------- | ------------- |\n| `current-time`   | `format`             | Format for current time. See [strftime(3)] for more details.     | `%H:%M:%S %z` |\n| `execution-time` | `min-display-second` | Only show execution time when last run is longer than this time. | 5             |\n\n[strftime(3)]: https://man7.org/linux/man-pages/man3/strftime.3.html\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftzing%2Fclover.zsh-theme","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftzing%2Fclover.zsh-theme","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftzing%2Fclover.zsh-theme/lists"}