{"id":18425223,"url":"https://github.com/firehead90544/how-cli","last_synced_at":"2025-08-21T09:06:20.702Z","repository":{"id":250376140,"uuid":"834293581","full_name":"FireHead90544/how-cli","owner":"FireHead90544","description":"An AI-based CLI assistant to help you with command line \u0026 shell.","archived":false,"fork":false,"pushed_at":"2024-07-28T15:44:12.000Z","size":93,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-10T13:27:48.709Z","etag":null,"topics":["artificial-intelligence","cli","langchain","llm","python","typer-cli"],"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/FireHead90544.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,"zenodo":null}},"created_at":"2024-07-26T21:40:19.000Z","updated_at":"2025-07-31T14:31:35.000Z","dependencies_parsed_at":"2025-08-10T13:12:15.714Z","dependency_job_id":"09b2cab0-d0ba-4bd6-827e-15ae9e8a0862","html_url":"https://github.com/FireHead90544/how-cli","commit_stats":null,"previous_names":["firehead90544/how","firehead90544/how-cli"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/FireHead90544/how-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FireHead90544%2Fhow-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FireHead90544%2Fhow-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FireHead90544%2Fhow-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FireHead90544%2Fhow-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FireHead90544","download_url":"https://codeload.github.com/FireHead90544/how-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FireHead90544%2Fhow-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271455062,"owners_count":24762699,"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-08-21T02:00:08.990Z","response_time":74,"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":["artificial-intelligence","cli","langchain","llm","python","typer-cli"],"created_at":"2024-11-06T05:03:04.330Z","updated_at":"2025-08-21T09:06:20.673Z","avatar_url":"https://github.com/FireHead90544.png","language":"Python","readme":"# how-cli\nAn AI-based CLI assistant to help you with command line \u0026 shell.\n\n\n## Demo \nhttps://github.com/user-attachments/assets/effefe1a-c0ed-4b60-838c-98f992f6c25f\n\n\n## Installation\n**1. Using `pip`**\n  - Ensure python is installed on your system. (Tested against Python 3.11+)\n  - Install the package using pip.\n  ```bash\n  pip install -U how-cli\n  ```\n**2. Manual Installation**\n  - Clone the repository \u0026 cd into it\n  ```bash\n  git clone https://github.com/FireHead90544/how-cli \u0026\u0026 cd how-cli\n  ```\n  - Ensure you're in a virtual environment.\n  - Install the application.\n  ```bash\n  pip install -e .\n  ```\n\n\n## Usage\n```console\n$ how [OPTIONS] COMMAND [ARGS]...\n```\n\n**Options**:\n* `-v, --version`: Shows the version of the application\n* `--install-completion`: Install completion for the current shell.\n* `--show-completion`: Show completion for the current shell, to copy it or customize the installation.\n* `--help`: Show this message and exit.\n\n**Commands**:\n* `setup`: Sets up the configuration required to run...\n* `to`: Sends the task to the LLM for analysis.\n\n\n## `how setup`\nSets up the configuration required to run the application.\nSet the LLM Provider \u0026 the corresponding API Key.\n\n**Usage**:\n```console\n$ how setup [OPTIONS]\n```\n\n**Options**:\n* `--interactive / --no-interactive`: Whether to use interactive mode for setting up configuration?  [default: interactive]\n* `--provider TEXT`: The LLM Provider, needs to be passed explicitly if using --no-interactive mode.\n* `--api-key TEXT`: The API Key for the LLM provider, needs to be passed explicitly if using --no-interactive mode.\n* `--help`: Show this message and exit.\n\n\n## `how to`\nSends the task to the LLM for analysis.\nReturns the commands to be executed in order to achieve that.\n\n**Usage**:\n```console\n$ how to [OPTIONS] TASK\n```\n\n**Arguments**:\n* `TASK`: The command line task to perform.  [required]\n\n**Options**:\n* `--help`: Show this message and exit.\n\n\n## Providers\n`how-cli` uses ChatModels as they support chat messages as opposed to TextModels and below model providers and their corresponding models are available to use. If you could test the models that are marked as ❌, please create an issue or pull request along with the test results.\n\n| Provider | Model | Package | Tested |\n|:--------:|:-----:|:-------:|:------:|\n| GoogleGenAI   | `gemini-1.5-flash` | `langchain-google-genai` | ✅ |\n| GoogleVertexAI | `gemini-1.5-flash` | `langchain-google-vertexai` | ❌ |\n| GroqMistralAI | `mixtral-8x7b-32768` | `langchain-groq` | ✅ |\n| GroqLLaMa | `llama3-70b-8192` | `langchain-groq` | ✅ |\n| OpenAI | `gpt-4o` | `langchain-openai` | ❌ |\n| Anthropic | `claude-3-5-sonnet-20240620` | `langchain-anthropic` | ❌ |\n\n\n# License\n`how-cil` is licensed under the MIT License, it can be found [here](https://github.com/FireHead90544/how-cli/blob/main/LICENSE).\n\n\n# Honourable Mentions\nThis project is greatly inspired by [kynnyhsap's](https://github.com/kynnyhsap) [how](https://github.com/kynnyhsap/how). Though my implementation is completely different (refer to the below image for architectural details), but at the core both the projects aims to do the same thing. Also, check out LangChain \u0026 Typer using which this project was built.\n\n![arch](https://github.com/user-attachments/assets/5335fb1d-7899-4ebf-9ff3-dfa139a9c5f8)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffirehead90544%2Fhow-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffirehead90544%2Fhow-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffirehead90544%2Fhow-cli/lists"}