{"id":31238938,"url":"https://github.com/axrona/pulsarship","last_synced_at":"2025-09-22T19:17:22.379Z","repository":{"id":305446013,"uuid":"1022521470","full_name":"axrona/pulsarship","owner":"axrona","description":"🚀🌠 A minimal, fast, and customizable terminal prompt written in Go","archived":false,"fork":false,"pushed_at":"2025-08-25T08:14:22.000Z","size":1582,"stargazers_count":11,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-08-25T10:43:04.546Z","etag":null,"topics":["bash","fish","fish-prompt","golang","linux","prompt","pulsarship","shell","shell-prompt","zsh","zsh-prompt"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/axrona.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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,"zenodo":null}},"created_at":"2025-07-19T08:52:57.000Z","updated_at":"2025-08-25T08:14:26.000Z","dependencies_parsed_at":null,"dependency_job_id":"6a59391b-3193-4ee3-9fa9-8503964e7be1","html_url":"https://github.com/axrona/pulsarship","commit_stats":null,"previous_names":["xeyossr/pulsarship","axrona/pulsarship"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/axrona/pulsarship","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/axrona%2Fpulsarship","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/axrona%2Fpulsarship/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/axrona%2Fpulsarship/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/axrona%2Fpulsarship/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/axrona","download_url":"https://codeload.github.com/axrona/pulsarship/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/axrona%2Fpulsarship/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276459313,"owners_count":25646336,"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-09-22T02:00:08.972Z","response_time":79,"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":["bash","fish","fish-prompt","golang","linux","prompt","pulsarship","shell","shell-prompt","zsh","zsh-prompt"],"created_at":"2025-09-22T19:17:20.043Z","updated_at":"2025-09-22T19:17:22.374Z","avatar_url":"https://github.com/axrona.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀🌠 Pulsarship\n\n\u003cdiv align=\"center\"\u003e\n  \n\u003c!-- Badges --\u003e\n[![License: GPL3](https://img.shields.io/github/license/axrona/pulsarship?style=for-the-badge\u0026logo=opensourceinitiative\u0026logoColor=white)](https://github.com/axrona/pulsarship/blob/main/LICENSE)\n[![Go Version](https://img.shields.io/badge/Go-1.24+-blue?style=for-the-badge\u0026logo=go\u0026logoColor=white)](https://golang.org/dl/)\n[![Release](https://img.shields.io/github/v/release/axrona/pulsarship?style=for-the-badge\u0026logo=github\u0026logoColor=white\u0026v=1)](https://github.com/axrona/pulsarship/releases/latest)\n[![Platform](https://img.shields.io/badge/platform-Linux-lightgrey?style=for-the-badge\u0026logo=linux\u0026logoColor=white)](https://www.kernel.org/)\n\n---\n\n**🚀 Pulsarship** is a minimal, fast and customizable shell prompt tool written in Go.\n\n[✨ Features](#-features) • [📦 Installation](#-installation) • [🔧 Shell Config](#-add-to-your-shell-config) • [🛠️ Configuration](#-configuration) • [📜 License](#-license)\n\n\u003c/div\u003e\n\n## ✨ Features\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd valign=\"top\"\u003e\n\n\n- ⚙️ \u003cb\u003eModular architecture\u003c/b\u003e – Easily customize each part of the prompt  \n- 🎨 \u003cb\u003eColor palette support\u003c/b\u003e – Define theme colors using `palette`  \n- 🧩 \u003cb\u003eComponents\u003c/b\u003e – Includes:\n  - `cwd`, `username`, `hostname`, `git`, `character`, etc  \n- 🧰 \u003cb\u003eCustom components\u003c/b\u003e – Define your own modules  \n- ⚡ \u003cb\u003eBlazing fast\u003c/b\u003e – Lightweight Go binary  \n- 🧪 \u003cb\u003eExtensible\u003c/b\u003e – Right prompt, async, etc  \n\n\u003c/td\u003e\n    \u003ctd valign=\"top\"\u003e\n      \u003cimg src=\"https://github.com/user-attachments/assets/e9ac28f5-a464-4a63-b74a-95968314ff0e\" width=\"400\"/\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\n---\n\n## 📦 Installation\n### 🔁 AUR (Arch Linux / Manjaro / EndeavourOS)\n\nIf you're using an Arch-based distribution, you can install `pulsarship` from the AUR using an AUR helper like [`yay`](https://github.com/Jguer/yay) or [`paru`](https://github.com/Morganamilo/paru):\n```bash\nyay -S pulsarship\n```\nor\n```bash\nparu -S pulsarship\n```\n\n### 🛠️ Install via Script\nYou can install `pulsarship` with a single command:\n\n```bash\ncurl -sS https://raw.githubusercontent.com/axrona/pulsarship/main/install.sh | bash\n```\n\nThis script will clone the repository, build the binary, and install it for you.\n\n### 🔧 Add to your shell config\nAdd the following to your `~/.config/fish/config.fish`:\n**Fish:**\n```bash\nset -Ux PULSARSHIP_CONFIG ~/.config/pulsarship/pulsarship.toml\npulsarship init fish | source\n```\n\n**Zsh:**\nAdd the following to your `~/.zshrc`:\n```zsh\nexport PULSARSHIP_CONFIG=\"$HOME/.config/pulsarship/pulsarship.toml\"\neval \"$(pulsarship init zsh)\"\n```\n\n**Bash:**\nAdd the following to your `~/.bashrc`:\n```bash\nexport PULSARSHIP_CONFIG=\"$HOME/.config/pulsarship/pulsarship.toml\"\neval \"$(pulsarship init bash)\"\n```\n\n\u003e Make sure to restart your shell or source the config file after editing:   \n\u003e `source ~/.config/fish/config.fish` or `source ~/.bashrc` or `source ~/.zshrc`\n\n## 🛠️ Configuration\n\nThe default config file location is `~/.config/pulsarship/pulsarship.toml`.   \nYou can generate this file by running the `pulsarship gen-config` command.\n\nPulsarship uses TOML-based configuration for customizing the prompt and other settings.   \nFor more information visit the [Wiki](https://github.com/axrona/pulsarship/wiki).\n\n## 🤝 Contributing\nContributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for details.\n\n## 🐞 Reporting Issues\nFound a bug or have a suggestion? [Open an issue](https://github.com/axrona/pulsarship/issues). Be concise and include any relevant output or screenshots.\n\n## 📜 License\nThis project is licensed under the **GNU General Public License v3.0.**\nSee the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faxrona%2Fpulsarship","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faxrona%2Fpulsarship","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faxrona%2Fpulsarship/lists"}