{"id":14982875,"url":"https://github.com/mnml-theme/prompt","last_synced_at":"2025-10-29T18:31:40.159Z","repository":{"id":142182377,"uuid":"318299325","full_name":"mnml-theme/prompt","owner":"mnml-theme","description":"A minimal @z-shell prompt theme.","archived":false,"fork":false,"pushed_at":"2023-11-21T17:44:34.000Z","size":58,"stargazers_count":9,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-02-02T04:11:13.306Z","etag":null,"topics":["git-prompt","git-workflow","minimal","minimalist","minimalistic","mnml","prompt","prompts","shell","terminal","theme","zsh","zsh-configuration","zsh-plugin","zsh-plugins","zsh-prompt","zsh-theme","zsh-themes","zshell","zshrc"],"latest_commit_sha":null,"homepage":"https://zsh-manual.netlify.app/user-contributions#266-prompt-themes","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/mnml-theme.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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":"2020-12-03T19:34:18.000Z","updated_at":"2024-05-20T10:17:03.000Z","dependencies_parsed_at":"2024-01-03T04:29:55.341Z","dependency_job_id":"e34fbbee-702d-4bce-bf9b-58b893aee579","html_url":"https://github.com/mnml-theme/prompt","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mnml-theme%2Fprompt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mnml-theme%2Fprompt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mnml-theme%2Fprompt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mnml-theme%2Fprompt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mnml-theme","download_url":"https://codeload.github.com/mnml-theme/prompt/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238874255,"owners_count":19545145,"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":["git-prompt","git-workflow","minimal","minimalist","minimalistic","mnml","prompt","prompts","shell","terminal","theme","zsh","zsh-configuration","zsh-plugin","zsh-plugins","zsh-prompt","zsh-theme","zsh-themes","zshell","zshrc"],"created_at":"2024-09-24T14:06:20.379Z","updated_at":"2025-10-29T18:31:34.556Z","avatar_url":"https://github.com/mnml-theme.png","language":"Shell","readme":"[\u003cimg src=\"https://raw.githubusercontent.com/mnml-theme/mnml.github.io/main/img/logo.svg\" width=\"12%\" align=\"right\"\u003e][mnml]\n\u003cbr\u003e\n\n[mnml] [prompt]\n===============\nA **m**i**n**i**m**a**l** [_Zsh_]ell [prompt theme].\n\n![](carbon.png)\n\n\\*Preview shows [_Dracula_ theme] with _[JetBrains Mono] [Nerd font]_.\n\nCompatible with [.files].\n\nInstall\n-------\nwith _[Home`brew`]_:\n~~~ sh\nbrew install mnml-theme/install/mnml-prompt\n~~~\nor [`brew bundle`]` install`[` --file`] from _[Brewfile]_:\n~~~ rb\ntap  \"mnml-theme/install\"\nbrew \"mnml-prompt\"\n~~~\n\nThen add to your [startup files]:\n~~~ sh\n# ~/.zshrc\nautoload -Uz promptinit\npromptinit\nprompt mnml\n~~~\nor simply [`export`] [`ZSH_THEME`] with [`ZDOTDIR`]:\n~~~ sh\n# $ZDOTDIR/source/*.env\nZSH_THEME=mnml\n~~~\n\nConfiguration\n------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\n| [Environment variable][env]       | Default value               | Description                                                          |\n|:----------------------------------|:----------------------------|:---------------------------------------------------------------------|\n| [`PS1`][PS]/[`PROMPT`][PS]        | `ZSH_PROMPT_SYMBOL`         | Default left aligned prompt.                                         |\n| [`RPS1`][PS]/[`RPROMPT`][PS]      | [`vcs_info`][vcs]           | Additional right aligned prompt.                                     |\n| [`ZLE_RPROMPT_INDENT`]            | `0`                         | Number of spaces indentation to the right of `RPS1`/`RPROMPT`.       |\n| `ZSH_PROMPT_NEWLINE`              | `true`                      | Add a newline after each command.                                    |\n| `ZSH_PROMPT_SYMBOL_COLOR`         | `default`                   | _[ANSI]_ [`color`] of `ZSH_PROMPT_SYMBOL`.                           |\n| `ZSH_PROMPT_COLOR_ERROR`          | `red`                       | ANSI `color` of `ZSH_PROMPT_SYMBOL_ERROR`.                           |\n| `ZSH_PROMPT_COLOR_COMMENT`        | `8`                         | ANSI bright black by default.                                        |\n| `ZSH_PROMPT_COLOR_JOBS`           | `ZSH_PROMPT_COLOR_COMMENT`  | ANSI `color` of `ZSH_PROMPT_SYMBOL_JOBS`.                            |\n| `ZSH_PROMPT_COLOR_PWD`            | `ZSH_PROMPT_COLOR_COMMENT`  | ANSI `color` of `ZSH_PROMPT_PWD`.                                    |\n| `ZSH_PROMPT_COLOR_ADDED`          | `green`                     | ANSI `color` of `ZSH_PROMPT_SYMBOL_ADDED` in `vcs_info`              |\n| `ZSH_PROMPT_COLOR_UNTRACKED`      | `ZSH_PROMPT_COLOR_ADDED`    | ANSI `color` of `ZSH_PROMPT_SYMBOL_UNTRACKED` in `vcs_info`.         |\n| `ZSH_PROMPT_COLOR_MODIFIED`       | `yellow`                    | ANSI `color` of `ZSH_PROMPT_SYMBOL_MODIFIED` in `vcs_info`.          |\n| `ZSH_PROMPT_COLOR_RENAMED`        | `blue`                      | ANSI `color` of `ZSH_PROMPT_SYMBOL_RENAMED` in `vcs_info`.           |\n| `ZSH_PROMPT_COLOR_DELETED`        | `ZSH_PROMPT_COLOR_ERROR`    | ANSI `color` of `ZSH_PROMPT_SYMBOL_DELETED` in `vcs_info`.           |\n| `ZSH_PROMPT_COLOR_STASHED`        | `ZSH_PROMPT_COLOR_JOBS`     | ANSI `color` of `ZSH_PROMPT_SYMBOL_STASHED` in `vcs_info`.           |\n| `ZSH_PROMPT_COLOR_REVISION`       | `ZSH_PROMPT_COLOR_STASHED`  | ANSI `color` of `ZSH_PROMPT_SYMBOL_REVISION` in `vcs_info`.          |\n| `ZSH_PROMPT_COLOR_BRANCH`         | `ZSH_PROMPT_COLOR_REVISION` | ANSI `color` of `ZSH_PROMPT_SYMBOL_BRANCH` in `vcs_info`.            |\n| `ZSH_PROMPT_SYMBOL`               | `\u003e`                         | Main `PS1`/`PROMPT` symbol.                                          |\n| `ZSH_PROMPT_SYMBOL_JOBS`          | `☰ `                        | Prefix `ZSH_PROMPT_SYMBOL` if any [jobs] running in the backround.   |\n| `ZSH_PROMPT_SYMBOL_ERROR`         |                             | Prefix `ZSH_PROMPT_SYMBOL` if last command resulted in an error.     |\n| `ZSH_PROMPT_SYMBOL_REVISION`      | ` `                        | Prefix `ZSH_PROMPT_REVISION` with [`commit` symbol]                  |\n| `ZSH_PROMPT_SYMBOL_BRANCH`        | ` `                        | Prefix `vcs_info` with [`branch` symbol].                            |\n| `ZSH_PROMPT_SYMBOL_UNTRACKED`     | `*`                         | Display if any [untracked] changes in `vcs_info`.                    |\n| `ZSH_PROMPT_SYMBOL_ADDED`         | `+`                         | Display if any [`add`]ed changes in `vcs_info`.                      |\n| `ZSH_PROMPT_SYMBOL_RENAMED`       | `~`                         | Display if any [renamed] changes in `vcs_info`.                      |\n| `ZSH_PROMPT_SYMBOL_MODIFIED`      | `ZSH_PROMPT_SYMBOL_ADDED`   | Display if any [modified][untracked] changes in `vcs_info`.          |\n| `ZSH_PROMPT_SYMBOL_DELETED`       | `-`                         | Display if any [deleted][untracked] changes in `vcs_info`.           |\n| `ZSH_PROMPT_SYMBOL_STASHED`       | `ZSH_PROMPT_SYMBOL_JOBS`    | Display if any [`stash`]es in `vcs_info`.                            |\n| `ZSH_PROMPT_SYMBOL_FETCH`         |                             | Prefix [`remote`] `vcs_info` with [`fetch`] symbol, such as [sync].  |\n| `ZSH_PROMPT_SYMBOL_BEHIND`        | `↓`                         | Display if any [`commit`]s behind the `remote` in `vcs_info`         |\n| `ZSH_PROMPT_SYMBOL_AHEAD`         | `↑`                         | Display if any `commit`s ahead of the `remote` in `vcs_info`.        |\n| `ZSH_PROMPT_SYMBOL_FORMAT_PREFIX` |                             | Prefix `ZSH_PROMPT_FORMAT` with symbol, such as `[`.                 |\n| `ZSH_PROMPT_SYMBOL_FORMAT_SUFFIX` |                             | Append `ZSH_PROMPT_FORMAT` with symbol, such as `]`.                 |\n| `ZSH_PROMPT_FORMAT`               | `%b%u%c%m`                  | Format of [`vcs_info`][vcs]. See [below table] for reference.        |\n| `ZSH_PROMPT_PWD`                  | false                       | Display the **P**resent **W**orking **D**irectory ([`PWD`][env]).    |\n| `ZSH_PROMPT_COUNT_JOBS`           | false                       | Display number of [jobs] running in the background.                  |\n| `ZSH_PROMPT_REVISION`             | false                       | Display latest `commit` [revision] hash in `vcs_info`.               |\n| `ZSH_PROMPT_REMOTE`               | false                       | Display `remote` [`branch`] in `vcs_info`.                           |\n| `ZSH_PROMPT_COUNT_FETCH`          | `true`                      | Display number of `commit`s ahead/behind the `remote` in `vcs_info`. |\n| `ZSH_PROMPT_COUNT_STASHED`        | false                       | Display number of `stash`es in `vcs_info`.                           |\n| `ZSH_PROMPT_COUNT_CHANGED`        | false                       | Prefix each change in `vcs_info` with number files changed.          |\n\n[`vcs_info`][vcs] reference:\n--------------------------------\n| `formats` | info             |\n|:----------|:-----------------|\n| `%b`      | [`branch`]       |\n| `%u`      | **u**n[`stage`]d |\n| `%c`      | `stage`d         |\n| `%m`      | [`stash`]ed      |\n| `%7.7i`   | [Revision]       |\n\nLicense\n-------\n[MIT] © [Daniel Bayley]\n\n[MIT]:                              LICENSE.md\n[Daniel Bayley]:                    https://github.com/danielbayley\n\n[mnml]:                             https://github.com/mnml-theme\n\n[_Dracula_ theme]:                  https://draculatheme.com/terminal\n[JetBrains Mono]:                   https://jetbrains.com/lp/mono\n[nerd font]:                        https://github.com/ryanoasis/nerd-fonts/tree/master/patched-fonts/JetBrainsMono\n\n[home`brew`]:                       https://brew.sh\n[`brew bundle`]:                    https://docs.brew.sh/Manpage#bundle-subcommand\n[brewfile]:                         https://github.com/Homebrew/homebrew-bundle#usage\n[.files]:                           https://github.com/danielbayley/homebrew-dotfiles#readme\n\n[_zsh_]:                            https://zsh-manual.netlify.app/introduction\n[`ZDOTDIR`]:                        https://github.com/danielbayley/zdotdir#readme\n[startup files]:                    https://zsh-manual.netlify.app/files?highlight=%24ZDOTDIR%2F.zshrc#51-startupshutdown-files\n[`export`]:                         https://zsh-manual.netlify.app/options?highlight=all_export#1625-initialisation\n[prompt]:                           https://en.wikipedia.org/wiki/Command-line_interface#Command_prompt\n[prompt theme]:                     https://zsh-manual.netlify.app/user-contributions#Prompt-Themes\n[ANSI]:                             https://en.wikipedia.org/wiki/ANSI_escape_code\n[`color`]:                          https://zsh-manual.netlify.app/user-contributions#26121-descriptions\n[env]:                              https://zsh-manual.netlify.app/parameters?highlight=environment%20variables#151-description\n[PS]:                               https://zsh-manual.netlify.app/parameters?highlight=PROMPT#156-parameters-used-by-the-shell\n[jobs]:                             https://zsh-manual.netlify.app/jobs-\u0026-signals#101-jobs\n\n[`ZLE_RPROMPT_INDENT`]:             https://zsh-manual.netlify.app/parameters?highlight=ZLE_RPROMPT_INDENT#156-parameters-used-by-the-shell\n[`ZSH_THEME`]:                      https://github.com/ohmyzsh/ohmyzsh/wiki/Settings#zsh_theme\n\n[vcs]:                              https://zsh-manual.netlify.app/user-contributions#2657-hooks-in-vcs_info\n[below table]:                      #vcs_info-reference\n[revision]:                         https://git-scm.com/book/en/v2/Git-Tools-Revision-Selection\n[untracked]:                        https://git-scm.com/book/en/Git-Basics-Recording-Changes-to-the-Repository\n[`branch`]:                         https://git-scm.com/docs/git-branch\n[`commit`]:                         https://git-scm.com/docs/git-commit\n[`add`]:                            https://git-scm.com/docs/git-add\n[`stage`]:                          https://git-scm.com/docs/git-stage\n[renamed]:                          https://git-scm.com/docs/git-mv\n[`stash`]:                          https://git-scm.com/docs/git-stash\n[`remote`]:                         https://git-scm.com/docs/git-remote\n[`fetch`]:                          https://git-scm.com/docs/git-fetch\n[`commit` symbol]:                  https://primer.style/octicons/git-commit-16\n[`branch` symbol]:                  https://primer.style/octicons/git-branch-16\n[sync]:                             https://primer.style/octicons/sync-16\n","funding_links":[],"categories":["Themes"],"sub_categories":["ZSH on Windows"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmnml-theme%2Fprompt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmnml-theme%2Fprompt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmnml-theme%2Fprompt/lists"}