{"id":17350518,"url":"https://github.com/egorlem/ultima.zsh-theme","last_synced_at":"2026-01-06T18:17:27.722Z","repository":{"id":37028586,"uuid":"289547953","full_name":"egorlem/ultima.zsh-theme","owner":"egorlem","description":"Minimalistic .zshrc configuration file designed to provide all the necessary settings for a comfortable terminal experience","archived":false,"fork":false,"pushed_at":"2024-12-28T16:10:17.000Z","size":847,"stargazers_count":98,"open_issues_count":0,"forks_count":5,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-30T21:09:49.009Z","etag":null,"topics":["alacritty","dotfiles","iterm2","linux","oh-my-zsh","oh-my-zsh-theme","shell","workspace","zsh","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":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/egorlem.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2020-08-22T18:50:45.000Z","updated_at":"2025-03-24T05:59:19.000Z","dependencies_parsed_at":"2022-07-31T23:39:05.926Z","dependency_job_id":"c63f5108-ca92-447c-95e9-ba7684b48b69","html_url":"https://github.com/egorlem/ultima.zsh-theme","commit_stats":{"total_commits":121,"total_committers":3,"mean_commits":"40.333333333333336","dds":"0.28099173553719003","last_synced_commit":"fe1473adfce00ef0187efe92ff13b1714047b4f4"},"previous_names":["egorlem/ultima.zsh-theme"],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/egorlem%2Fultima.zsh-theme","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/egorlem%2Fultima.zsh-theme/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/egorlem%2Fultima.zsh-theme/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/egorlem%2Fultima.zsh-theme/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/egorlem","download_url":"https://codeload.github.com/egorlem/ultima.zsh-theme/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247557770,"owners_count":20958047,"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":["alacritty","dotfiles","iterm2","linux","oh-my-zsh","oh-my-zsh-theme","shell","workspace","zsh","zsh-theme"],"created_at":"2024-10-15T17:07:15.517Z","updated_at":"2026-01-06T18:17:27.714Z","avatar_url":"https://github.com/egorlem.png","language":"Shell","funding_links":[],"categories":["Themes"],"sub_categories":["ZSH on Windows"],"readme":"# Ultima [ˈultima] — Minimalist Zsh theme\n\n### Clean, clear, and visually structured.\n\n![GitHub Release](https://img.shields.io/github/v/release/egorlem/ultima.zsh-theme?style=for-the-badge\u0026color=7CD996\u0026labelColor=212121)\n![Static Badge](https://img.shields.io/badge/License-WTFPL-blue?style=for-the-badge\u0026labelColor=212121\u0026color=59D9D0\u0026link=https%3A%2F%2Fgithub.com%2Fegorlem%2Fultima.zsh-theme%2Fblob%2Ff8a01d549ee38e720a597f9632ccf7960c7b9c8e%2FLICENSE)\n\n---\n\n![item zsh prompt](https://github.com/egorlem/021011/blob/main/demos/zsh-theme-demo-min.png?raw=true) \n\n---\n\n## Features And Prompt\n\n### Prompt Structure\n\n* **Three-level prompt** — top line separates previous output, middle shows key information (working directory, SSH, VCS), bottom is for command input.\n* **Unified sigil (`›`)** — used consistently across all input lines (`PS1`, `PS2`, `PS3`). The sigil marks the beginning of the input line and indicates the prompt is ready for a new command.\n\n### Key Features\n\n* **Working directory** — shows the current path.\n* **VCS status** — displayed only inside a repository: current action (e.g., `rebase` or `merge`), short commit hash, file changes (`A` — added, `M` — modified, `U` — untracked), and branch.\n* **SSH indicator** — shown only during remote sessions.\n* **Exit status indicator (RPROMPT)** — displayed on the right side of the prompt:\n  * green `•` — last command exited successfully (`0`)\n  * red `• \u003ccode\u003e` — last command failed, showing its exit status code\n\n---\n\n## Installation\n\nUltima Zsh theme can be installed in three ways: with **full module management via Veil**, manually for a **lightweight setup**, or through popular **Zsh frameworks and plugin managers**.\n\n---\n\n### Recommended: Veil\n\n\u003e Features like `less`, `ls`, completion, and other shell behavior are now part of **Veil**. Installing Veil automatically includes Ultima.\n\n```shell\n# Clone Veil repository\ngit clone https://github.com/egorlem/veil.zsh ~/.veil\n\n# Source Veil in your .zshrc (includes Ultima theme)\necho 'source ~/.veil/veil.zsh' \u003e\u003e ~/.zshrc\n```\n\n\u003e For advanced module configuration, see [Veil Documentation](https://github.com/egorlem/veil.zsh).\n\n---\n\n### Manual Installation\n\n\u003e Include Ultima without Veil if you prefer minimal changes.\n\n```shell\n# Clone Ultima repository\ngit clone https://github.com/egorlem/ultima.zsh-theme ~/.ultima\n\n# Source Ultima in your .zshrc\necho 'source ~/.ultima/ultima.zsh-theme' \u003e\u003e ~/.zshrc\n```\n\n---\n\n### Integration with Zsh Frameworks and Plugin Managers\n\n#### Zim\n\n```shell\n# Add Ultima to your .zimrc\necho 'zmodule egorlem/ultima.zsh-theme -n ultima' \u003e\u003e ~/.zimrc\n```\n\n#### zcomet\n\n```shell\n# Load Ultima via zcomet\nzcomet load egorlem/ultima.zsh-theme\n\n# Ensure `zcomet compinit` is called after loading\n```\n\n#### Oh My Zsh\n\n```shell\n# Clone repository\ngit clone https://github.com/egorlem/ultima.zsh-theme ~/ultima-shell\n\n# Move theme to Oh My Zsh theme folder\nmv ~/ultima-shell/ultima.zsh-theme $ZSH/themes/ultima.zsh-theme\n\n# Set theme in your .zshrc\nZSH_THEME=\"ultima\"\n```\n\n---\n\n## Recommended Settings and Compatibility\n\n### Terminal and Color Scheme\n\nFor the best experience, use the **Ghostty** terminal together with the **Guezwhoz** color scheme.\n\n**Guezwhoz** is a balanced dark color scheme designed with a focus on visual comfort and readability.  \nThe theme meets the WCAG 2.1 AA accessibility standard and is based on the principles of analogous color harmony, providing a pleasant, cohesive color experience during long terminal sessions.\n\n**For [Ghostty](https://github.com/ghostty-org/ghostty) and [Wezterm](https://github.com/wezterm/wezterm) users:**  \nSet the color scheme to `guezwhoz` in your terminal configuration. **Guezwhoz** is bundled by default with **Ghostty** and **Wezterm**—no additional installation required.\n\n**For other terminals:**  \nYou can install the **Guezwhoz** theme from the [@mbadolato/iTerm2-Color-Schemes](https://github.com/mbadolato/iTerm2-Color-Schemes) repository.\n\nThese recommendations ensure optimal appearance and compatibility for this project. Using other terminals or color schemes may result in a different visual experience.\n\n### Fonts\n\nNot all fonts include the U+203A Unicode character (Single Right-Pointing Angle Quotation Mark). Unless your system font supports this character, install one of the standard fonts, such as **Arial**, **Consolas**, or **Impact**.\n\nFor comfortable work, I recommend [JetBrains Mono](https://www.jetbrains.com/lp/mono/).  \nThis font already includes all the characters used in the theme and is ideal for full compatibility.\n\n\u003e This theme is developed and tested using Ghostty, JetBrains Mono, Veil, the Guezwhoz color scheme, and the standard zsh-users plugin set.\n\n---\n\n## License\n\n**Do What The F*ck You Want To Public License, Version 2**\nSee [LICENSE](https://github.com/egorlem/ultima.zsh-theme/blob/f8a01d549ee38e720a597f9632ccf7960c7b9c8e/LICENSE) for details.\n\nMaintained by [Egor Lem](https://egorlem.com/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fegorlem%2Fultima.zsh-theme","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fegorlem%2Fultima.zsh-theme","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fegorlem%2Fultima.zsh-theme/lists"}