{"id":15642958,"url":"https://github.com/dolmen/angel-ps1","last_synced_at":"2025-04-30T10:07:55.786Z","repository":{"id":8519090,"uuid":"10133281","full_name":"dolmen/angel-PS1","owner":"dolmen","description":"Your fancy shell prompt fed by your guardian angel","archived":false,"fork":false,"pushed_at":"2021-04-21T11:53:24.000Z","size":520,"stargazers_count":61,"open_issues_count":15,"forks_count":4,"subscribers_count":6,"default_branch":"release","last_synced_at":"2025-02-25T06:43:26.181Z","etag":null,"topics":["bash","fish-shell","ksh","mksh","powerline","prompt","prompt-toolkit","shell-prompt","unix","zsh"],"latest_commit_sha":null,"homepage":"https://twitter.com/nglPS1","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dolmen.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-05-17T22:27:13.000Z","updated_at":"2024-04-14T19:36:14.000Z","dependencies_parsed_at":"2022-09-07T21:53:59.175Z","dependency_job_id":null,"html_url":"https://github.com/dolmen/angel-PS1","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dolmen%2Fangel-PS1","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dolmen%2Fangel-PS1/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dolmen%2Fangel-PS1/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dolmen%2Fangel-PS1/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dolmen","download_url":"https://codeload.github.com/dolmen/angel-PS1/tar.gz/refs/heads/release","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242635331,"owners_count":20161437,"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":["bash","fish-shell","ksh","mksh","powerline","prompt","prompt-toolkit","shell-prompt","unix","zsh"],"created_at":"2024-10-03T11:58:23.042Z","updated_at":"2025-03-09T02:30:40.885Z","avatar_url":"https://github.com/dolmen.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"![angel-PS1 logo][1] angel-PS1 - The Angel's Prompt\n===================================================\n\n   [1]: doc/images/angel-PS1_64.png\n\n`angel-PS1` is your guardian angel for the Unix world.\n\n\nThe implementation is a\n[*daemon*](https://en.wikipedia.org/wiki/Daemon_%28computing%29),\na background process, that will service your shell every time it needs to\ndisplay the prompt.\n\nThis is a daemon, but not a nasty demon. So it is an angel. Like a\nguardian angel, attached to the shell and who gives him precious\ninformation about the world around that you can't see. You'll not see him,\nbut he is there. Always around, but always discreet.\n\n*There is absolutely no relation between this project and\n[AngelCode / AngelScript](http://www.angelcode.com/angelscript/).*\n\n### Build status\n\n[`release`](https://github.com/dolmen/angel-PS1/tree/release): [![Build status](https://travis-ci.org/dolmen/angel-PS1.png?branch=release)](https://travis-ci.org/dolmen/angel-PS1)\n\n[`devel`](https://github.com/dolmen/angel-PS1/tree/devel): [![Build status](https://travis-ci.org/dolmen/angel-PS1.png?branch=devel)](https://travis-ci.org/dolmen/angel-PS1)\n\n### Basic usage\n\n#### Download and install\n\n    wget https://github.com/dolmen/angel-PS1/raw/release/angel-PS1\n    chmod u+x angel-PS1\n\nThat's it! Easy, isn't it?\n\n#### Run\n\nTry this in your Unix/Linux shell to get a fancy prompt with the default\nsettings:\n\n[`bash`](https://www.gnu.org/software/bash/)/[`zsh`](http://www.zsh.org/)/[`mksh`](https://www.mirbsd.org/mksh.htm)/[`dash`](http://gondor.apana.org.au/~herbert/dash/)/[`ksh93`](http://www.kornshell.com/)/[`tcsh`](http://tcsh.org/):\n\n    eval `./angel-PS1`\n\n[`fish`](http://fishshell.com):\n\n    eval (./angel-PS1)\n\n**Note:** this project is still very young. Use at\nyour own risks in `~/.bashrc`/`.zshrc`/`.tcshrc`...\n\n\nYou can also try other example themes from the repository:\n\n    git clone https://github.com/dolmen/angel-PS1.git\n    cd angel-PS1\n    eval $(./angel-PS1 -c examples/Powerline-basic.PS1)\n\n\n\n#### Documentation\n\n    perldoc ./angel-PS1\n\nSorry, the documentation is quite light at the moment.\n\n### Supported shells\n\n#### First class\n\n- `bash`\n- `mksh`\n- `dash`\n- `ksh93`\n- `zsh`\n- `fish`\n\n#### Experimental\n\n- `tcsh`: see [issue #1](https://github.com/dolmen/angel-PS1/issues/1) (major issue)\n- `csh`:\n   - on Darwin (OS X), shell detection doesn't work unless the shell is\n     started as a login shell (csh -l)\n\n### Features\n\nAngel's Prompt is not just another new fancy prompt for your Unix shell.\nThis is also:\n\n* **A powerful, but still fast, prompt.** Thanks an original architecture,\n  you are not limited anymore by the speed of your shell and the cost of\n  forking processes.\n* **Not just *my* prompt, but *your* prompt.** You can configure your own\n  look using plugins.\n* **A prompt written in Perl.** Perl is the powerful companion to your\n  sysadmin tasks, but also an expressive general programming language that has\n  access the C Unix API. Perl is available on every Unix-like operating system,\n  and usually installed among core packages.\n* **A prompt building framework.** The API will help you to easily build your\n  own prompt using plugins, and to build plugins that you'll share with others.\n  With a powerful engine that allows you to easily specify colors and to\n  transparently escape shell special characters.\n* **[CPAN](https://metacpan.org/) power.** Thanks to Perl and its community,\n  you have access to the thousands of Perl modules on the CPAN to efficiently\n  and/or portably retrieve information that you will show in the prompt.\n* **Write once, run anywhere.** Write your prompt configuration once, and use\n  it in any shell supported by `angel-PS1`. And `angel-PS1` is a single file,\n  easy to move from machine to machine and run with any Perl, from 5.8.3 to\n  5.18+. As your prompt definition is also written in Perl, it has the\n  same portability.\n\n### News\n\nFollow \u003ca href=\"https://twitter.com/nglPS1\"\u003e@nglPS1\u003c/a\u003e on Twitter.\n\n### Support\n\n* IRC: [irc.perl.org, channel #angel-PS1](irc://irc.perl.org/angel-PS1)\n* [issues on Github](https://github.com/dolmen/angel-PS1/issues)\n\n### Copyright \u0026 license\n\nCopyright 2013-2018 Olivier Mengué.\n\n`angel-PS1` itself is distributed under the GNU Affero General Public License\nversion 3 or later. See [COPYING](COPYING) for details.\n\n`angel-PS1` plugins must be distributed under the\n[Artistic License 2.0](http://opensource.org/licenses/Artistic-2.0).\nThis basically allows to reuse the code of plugins either to improve the\n`angel-PS1` core or for any other usage in Perl programs, not just `angel-PS1`.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdolmen%2Fangel-ps1","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdolmen%2Fangel-ps1","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdolmen%2Fangel-ps1/lists"}