{"id":19356360,"url":"https://github.com/mceck/shy-sh","last_synced_at":"2025-04-06T13:09:12.758Z","repository":{"id":250954532,"uuid":"835963592","full_name":"mceck/shy-sh","owner":"mceck","description":"Shell copilot - sh shell AI copilot","archived":false,"fork":false,"pushed_at":"2025-03-29T16:55:58.000Z","size":4224,"stargazers_count":53,"open_issues_count":0,"forks_count":4,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-29T17:31:56.324Z","etag":null,"topics":["ai","assistant","bash","cli","copilot","llm","shell"],"latest_commit_sha":null,"homepage":"","language":"Python","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/mceck.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,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-30T22:08:16.000Z","updated_at":"2025-03-29T16:56:01.000Z","dependencies_parsed_at":"2024-12-21T23:21:29.351Z","dependency_job_id":"1d7be7ac-d229-433e-8e71-b83c516bc5fc","html_url":"https://github.com/mceck/shy-sh","commit_stats":{"total_commits":67,"total_committers":3,"mean_commits":"22.333333333333332","dds":"0.17910447761194026","last_synced_commit":"ff4fa8f977f5434ebc1cae5c7df58b1fbbea6092"},"previous_names":["mceck/shy-sh"],"tags_count":24,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mceck%2Fshy-sh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mceck%2Fshy-sh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mceck%2Fshy-sh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mceck%2Fshy-sh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mceck","download_url":"https://codeload.github.com/mceck/shy-sh/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247485287,"owners_count":20946398,"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":["ai","assistant","bash","cli","copilot","llm","shell"],"created_at":"2024-11-10T07:04:08.192Z","updated_at":"2025-04-06T13:09:12.732Z","avatar_url":"https://github.com/mceck.png","language":"Python","funding_links":[],"categories":["\u003ca name=\"copilot\"\u003e\u003c/a\u003eCo-pilot"],"sub_categories":[],"readme":"# Shy.sh\n\nSh shell AI copilot\n\n![image_cover](./docs/images/sh.gif)\n\n## Install\n\n```sh\npip install shy-sh\n```\n\nConfigure your LLM\n\n```sh\nshy --configure\n```\n\nSupported providers: openai, anthropic, google, groq, aws, ollama\n\n## Help\n\nUsage: `shy [OPTIONS] [PROMPT]...`\n\nArguments\nprompt [PROMPT]\n\nOptions\n\n- -x Do not ask confirmation before executing scripts\n- -e Explain the given shell command\n- --configure Configure LLM\n- --help Show this message and exit.\n\n## Settings\n\n```sh\nshy --configure\n Provider: ollama\n Model: llama3.2\n Agent Pattern: react\n Temperature: 0.0\n Language: klingon\n Safe Mode: Yes\n```\n\n#### Configurable settings\n\n- Provider: The LLM provider to use [OpenAI, Anthropic, Google, Groq, AWS Bedrock, Ollama(local)].\n- API Key: The API key for the LLM provider. (Format for aws bedrock: `region_name acces_key secret_key`)\n- Model: The LLM model to use.\n- Agent Pattern: react or function_call. (If you are not using OpenAI, Anthropic or Google, react is recommended)\n- Temperature: The LLM model's temperature setting.\n- Language: The language for the LLM's final answers.\n- Safe Mode: When enabled, no commands or scripts will be executed on your system; you will only receive suggestions. This feature is recommended for beginners.\n\nAll the settings are saved in `~/.config/shy/config.yml`\n\n## Examples\n\n```sh\n\u003e shy find all python files in this folder\n\n🛠️ find . -type f -name '*.py'\n\nDo you want to execute this command? [Yes/no/copy/explain/alternatives]:\n\n./src/chat_models.py\n./src/agent/tools.py\n./src/agent/__init__.py\n./src/agent/agent.py\n./src/settings.py\n./src/main.py\n\n🤖: Here are all the Python files found in the current folder and its subfolders.\n```\n\n```sh\n\u003e shy -x convert aaa.png to jpeg and resize to 200x200\n\n🛠️ convert aaa.png -resize 200x200 aaa.jpg\n\n🤖: I converted the file aaa.png to JPEG format and resized it to 200x200 pixels.\n```\n\n```sh\n\u003e shy resize movie.avi to 1024x768 and save it in mp4\n\n🛠️ ffmpeg -i movie.avi -vf scale=1024:768 -c:v libx264 output.mp4\n\nDo you want to execute this command? [Yes/no/copy/explain/alternatives]: c\n\n🤖: Command copied to the clipboard!\n```\n\n```sh\n\u003e shy\n\n✨: Hello, how are you?\n\n🤖: Hello! I'm fine thanks\n\n✨: how many files in this folder\n\n🛠️ ls | wc -l\n\nDo you want to execute this command? [Yes/no/copy/explain/alternatives]:\n\n5\n\n✨: exit\n\n🤖: 👋 Bye!\n```\n\n```sh\n\u003e shy -e \"find . -type f -name '*.py' | wc -l\"\n\n🤖: This shell command uses `find` to search for files (`-type f`) with the extension `.py` (`-name '*.py'`) in the current directory (`.`) and its subdirectories.\nThe results are then piped to `wc -l`, which counts the number of line.\nIn conclusion, the command presents the total count of Python files (*.py) located within the current directory and its subdirectories.\n```\n\n![image_python](./docs/images/python.gif)\n\n![image_ascii](./docs/images/ascii.gif)\n\n## Privacy\n\nIf you are not using Ollama as provider, please note that information such as the current path, your operating system name, and the last commands executed in the shell may be included in the LLM context.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmceck%2Fshy-sh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmceck%2Fshy-sh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmceck%2Fshy-sh/lists"}