{"id":18288937,"url":"https://github.com/mrpicklepinosaur/shrs","last_synced_at":"2025-04-12T18:53:14.290Z","repository":{"id":124345459,"uuid":"596756751","full_name":"MrPicklePinosaur/shrs","owner":"MrPicklePinosaur","description":"The rusty shell toolkit for hackers","archived":false,"fork":false,"pushed_at":"2024-04-12T20:19:36.000Z","size":3823,"stargazers_count":228,"open_issues_count":109,"forks_count":20,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-04-13T18:02:05.515Z","etag":null,"topics":["contributions-welcome","posix","posix-shell","rust","shell","shrs","unix"],"latest_commit_sha":null,"homepage":"https://mrpicklepinosaur.github.io/shrs/","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MrPicklePinosaur.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE-APACHE","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}},"created_at":"2023-02-02T21:34:24.000Z","updated_at":"2024-06-01T19:00:12.777Z","dependencies_parsed_at":"2024-04-14T20:43:39.592Z","dependency_job_id":null,"html_url":"https://github.com/MrPicklePinosaur/shrs","commit_stats":null,"previous_names":["mrpicklepinosaur/sh.rs"],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrPicklePinosaur%2Fshrs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrPicklePinosaur%2Fshrs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrPicklePinosaur%2Fshrs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrPicklePinosaur%2Fshrs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MrPicklePinosaur","download_url":"https://codeload.github.com/MrPicklePinosaur/shrs/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248618243,"owners_count":21134200,"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":["contributions-welcome","posix","posix-shell","rust","shell","shrs","unix"],"created_at":"2024-11-05T14:03:46.582Z","updated_at":"2025-04-12T18:53:14.266Z","avatar_url":"https://github.com/MrPicklePinosaur.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"media/shrs_banner.png\" alt=\"sh.rs\"\u003e\n\nThe rusty shell toolkit for hackers\n\n[![crates.io](https://img.shields.io/crates/v/shrs.svg)](https://crates.io/crates/shrs)\n[![Doc](https://docs.rs/shrs/badge.svg)](https://docs.rs/shrs)\n[![book](https://img.shields.io/badge/book-website-orange)](https://mrpicklepinosaur.github.io/shrs/docs/getting-started/introduction/)\n[![MIT/Apache 2.0](https://img.shields.io/badge/license-MIT%2FApache-blue.svg)](#)\n[![Discord](https://img.shields.io/discord/1109393362626297856?label=\u0026logo=discord\u0026logoColor=ffffff\u0026color=7389D8\u0026labelColor=6A7EC2)](https://discord.gg/XYeMseQrbM)\n\n\u003c/div\u003e\n\n## PROJECT GOALS\n\n- **hackable**: almost every aspect of the shell should be easily customizable and extendable\n- **developer friendly**: well documented and easy to contribute to\n- **rusty**: implemented in and configurable in rust\n\n## FEATURES\n\n\u003cimg width=50% src=\"media/demo.gif\"/\u003e\n\nDISCLAIMER: **shrs** is currently very much a work in progress, the API is subject to change frequently and things are prone to breaking. It currently may not be suitable for daily use, but is great for prototyping any experimental shell features you dream up with!\n\nHere are what makes **shrs** special:\n- Completely configurable in rust (including your prompt, completions and more!)\n- Plugin system (community maintained plugins that add unique features)\n\n## GETTING STARTED\n\nTo get a taste of what **shrs** is capable of, without any configuration, you can run the example **shrs_example** shell that is bundled by running:\n```sh\ngit clone https://github.com/MrPicklePinosaur/shrs.git\ncd ./shrs/shrs_example\ncargo run\n```\n\nTo get started with building your own shell, it's as easy as creating a new cargo project with:\n```rust\nuse shrs::prelude::*;\n\nfn main() {\n    let myshell = ShellBuilder::default()\n        .build()\n        .unwrap();\n\n    myshell.run();\n}\n```\n\nSee the [developer documentation](https://mrpicklepinosaur.github.io/shrs/docs/getting-started/introduction/) for more in depth information.\n\n## CONTRIBUTING\n\nIf you encounter and bugs are have any feature requests, please don't hesitate to [leave an issue](https://github.com/MrPicklePinosaur/shrs/issues)! Also take a look at the section for contributors in the [documentation](https://mrpicklepinosaur.github.io/shrs/docs/contributing/how-to-contribute/).\n\n## COMMUNITY PLUGINS\n\nList of cool 3rd part plugins and community built shells can be found in [awesome_shrs](https://github.com/MrPicklePinosaur/awesome_shrs). Some notable examples includes\n- [shrs_insulter](https://github.com/nithinmuthukumar/shrs_insulter): port of [bash insulter](https://github.com/hkbakke/bash-insulter)\n- [shrs_openai](https://github.com/MrPicklePinosaur/shrs_openai): chatgpt for your shell\n- [shrs_presence](https://github.com/nithinmuthukumar/shrs_presence): show shrs on discord presence\n- [shrs_sound](https://github.com/nithinmuthukumar/shrs_sound): play sounds in your shell\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrpicklepinosaur%2Fshrs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmrpicklepinosaur%2Fshrs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrpicklepinosaur%2Fshrs/lists"}