{"id":28155925,"url":"https://github.com/ngpepin/aido","last_synced_at":"2026-05-05T00:37:06.081Z","repository":{"id":226268418,"uuid":"768221580","full_name":"ngpepin/aido","owner":"ngpepin","description":"Bash scripts for in-line CLI review, editing and execution of Bash commands suggested by an LLM in response to a user's requests for assistance.","archived":false,"fork":false,"pushed_at":"2024-07-19T18:35:38.000Z","size":17,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-11T00:01:43.112Z","etag":null,"topics":["assistant-chat-bots","bash","bash-completion","bash-prompt","bashrc","command-line-tool","linux","llama","llm","llm-agent","mixtral-8x7b"],"latest_commit_sha":null,"homepage":"","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/ngpepin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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}},"created_at":"2024-03-06T17:30:56.000Z","updated_at":"2024-07-19T18:35:41.000Z","dependencies_parsed_at":"2024-03-06T19:15:37.820Z","dependency_job_id":"88e7d0f5-dd2d-477f-9518-c0e5661524ce","html_url":"https://github.com/ngpepin/aido","commit_stats":{"total_commits":5,"total_committers":1,"mean_commits":5.0,"dds":0.0,"last_synced_commit":"141653084959eb3e68be7109c2606ad44faa3ccf"},"previous_names":["ngpepin/aido"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ngpepin%2Faido","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ngpepin%2Faido/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ngpepin%2Faido/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ngpepin%2Faido/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ngpepin","download_url":"https://codeload.github.com/ngpepin/aido/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254292088,"owners_count":22046428,"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":["assistant-chat-bots","bash","bash-completion","bash-prompt","bashrc","command-line-tool","linux","llama","llm","llm-agent","mixtral-8x7b"],"created_at":"2025-05-15T07:14:51.738Z","updated_at":"2026-05-05T00:37:06.027Z","avatar_url":"https://github.com/ngpepin.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \"AI do!\" (aido) \u0026 \"sudo AI do!\" (saido)\n\nVery simple/simplistic Bash scripts for in-line CLI review, editing and execution of Bash commands suggested by an LLM in response to a user's requests for assistance.\n\n- `aido` and `saido` are Bash aliases leveraging a backing function designed to execute Bash commands that have been suggested by an LLM (Language Model) based on natural language user prompts. \n- These tools integrate seamlessly into your `.bashrc` file, providing an in-line method to request Bash command guidance.\n\n## Purpose\n\n`aido` and `saido` are designed to provide users with a convenient interface for executing Bash commands as either a non-root user or as root, respectively, as suggested by a Language Learning Model (LLM). They serve as handy tools for those who may not remember every Bash command or who seek a targeted and actionable reminder without any tl;dr.\n\n## Safety \u0026 Security\n\nUsers must manually approve and can modify any LLM-suggested command before execution. This measure ensures control and conscious user consent before any command execution, particularly for those prefixed by `sudo`. However, please note that this is a proof-of-concept and that users are wholly responsible for commands they execute, especially since `eval` is used for execution.\n\n## Usage\n\nAdd the following aliases to your `.bashrc` to use (these are provided in the aido-bashrc-snippet.sh):\n\n```bash\nalias aido='aido_func aido -u'\nalias saido='aido_func saido -a'\n```\n\n## Setup\n\nEnsure the `aichat` package and any required LLM servers (like `ollama`) or cloud API services are properly configured on your machine. Add the provided function and aliases to your `.bashrc` file to enable the functionality.\n\n## Dependencies\n\nThis script relies on the `aichat` package for LLM communication and might require local or remote LLM servers depending on your setup.\n\nRefer to:\n\n- `aichat` installation: [aichat GitHub page](https://github.com/sigoden/aichat)\n- `ollama` server setup: [Ollama Homepage](https://ollama.com)\n\n## Shortcomings and Constraints\n\nThe script may require prompt optimization for specific LLM models and does not support multiple command recommendations or maintain context between interactions.\n\n## Test Coverage and Limitations\n\nCurrently tested with the `ollama` server and Eric Hartford's `dolphin-mixtral-8x7b` model. Other models and extensive prompt engineering have not been tested.\n\n## Possible Alternatives\n\nExplore other integrations like [Shell GPT](https://github.com/TheR1D/shell_gpt).\n\n## License\n\nThis project is open-sourced under the MIT License. See the LICENSE file for details.\n\n## Contributing\n\nContributions are welcome! \n\n## Disclaimer\n\nThis project is for educational and proof-of-concept purposes only. No guarantees are provided regarding the safety, security, or suitability of the suggested commands. Users are responsible for reviewing and executing commands at their own risk.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fngpepin%2Faido","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fngpepin%2Faido","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fngpepin%2Faido/lists"}