{"id":29195448,"url":"https://github.com/haideryzai/aicmd-apt","last_synced_at":"2026-04-17T08:01:56.656Z","repository":{"id":301242639,"uuid":"1008614649","full_name":"haideryzai/aicmd-apt","owner":"haideryzai","description":"aicmd is a powerful command-line tool that transforms your natural language questions into executable Linux shell commands.","archived":false,"fork":false,"pushed_at":"2025-06-25T21:22:46.000Z","size":11,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-03T04:50:05.556Z","etag":null,"topics":["aitool","bash","cmd","generative-ai","linux","linux-shell","terminal"],"latest_commit_sha":null,"homepage":"https://haideryzai.github.io/aicmd-apt/","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/haideryzai.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-06-25T20:26:34.000Z","updated_at":"2025-06-27T08:56:55.000Z","dependencies_parsed_at":"2025-06-25T22:32:05.766Z","dependency_job_id":null,"html_url":"https://github.com/haideryzai/aicmd-apt","commit_stats":null,"previous_names":["haideryzai/aicmd-apt"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/haideryzai/aicmd-apt","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/haideryzai%2Faicmd-apt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/haideryzai%2Faicmd-apt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/haideryzai%2Faicmd-apt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/haideryzai%2Faicmd-apt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/haideryzai","download_url":"https://codeload.github.com/haideryzai/aicmd-apt/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/haideryzai%2Faicmd-apt/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31920518,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-16T18:22:33.417Z","status":"online","status_checked_at":"2026-04-17T02:00:06.879Z","response_time":62,"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":["aitool","bash","cmd","generative-ai","linux","linux-shell","terminal"],"created_at":"2025-07-02T05:04:28.825Z","updated_at":"2026-04-17T08:01:56.638Z","avatar_url":"https://github.com/haideryzai.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- GitAds-Verify: AWXOXS21FHN65KI13FN6SB85NDWGD5HK --\u003e\n# `aicmd`: Your AI-Powered Linux Command Assistant\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Linux](https://img.shields.io/badge/OS-Linux-informational?style=flat\u0026logo=linux\u0026logoColor=white)](https://www.linux.org/)\n\n## Overview\n\n## GitAds Sponsored\n[![Sponsored by GitAds](https://gitads.dev/v1/ad-serve?source=haideryzai/aicmd-apt@github)](https://gitads.dev/v1/ad-track?source=haideryzai/aicmd-apt@github)\n\n\n`aicmd` is a powerful command-line tool that transforms your natural language questions into executable Linux shell commands. Powered by Google's Gemini AI, `aicmd` makes navigating the terminal easier for everyone, from beginners to seasoned users looking for quick command recall. Simply ask what you want to do, and `aicmd` will provide the command.\n\n## Features\n\n* **Natural Language to Command:** Converts plain English queries into precise Linux commands.\n* **Gemini AI Integration:** Leverages the advanced capabilities of Google Gemini for accurate translations.\n* **Optional Command Execution:** Displays the generated command and gives you the option to run it directly.\n* **Secure API Key Management:** Prompts for your Gemini API key on first use and stores it securely.\n* **Easy Key Renewal:** Update your API key anytime with a simple command.\n* **Beginner-Friendly:** Great for new Linux users to learn commands quickly.\n* **Efficiency Boost:** Helps experienced users recall complex or less frequently used commands.\n\n## Installation (For Users)\n\n`aicmd` is designed for Debian/Ubuntu-based Linux systems.\n\n1.  **Ensure Prerequisites:**\n    Make sure you have `curl` and `jq` installed on your system. These are usually available by default, but you can install them if needed:\n    ```bash\n    sudo apt update\n    sudo apt install curl jq\n    ```\n\n2.  **Add the `aicmd` APT Repository:**\n   To allow apt to find and install aicmd, you need to add its repository to your system.\n    ```bash\n        wget https://haideryzai.github.io/aicmd-apt/aicmd-apt-repo-key.gpg -O /tmp/aicmd.gpg\n        sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/aicmd-repo.gpg /tmp/aicmd.gpg\n        echo \"deb [signed-by=/etc/apt/trusted.gpg.d/aicmd-repo.gpg] https://haideryzai.github.io/aicmd-apt stable main\" | sudo tee /etc/apt/sources.list.d/aicmd.list \u003e /dev/null\n    ```\n\n3.  **Install `aicmd`:**\n    Update your package lists to include the new repository, and then proceed with the installation of `aicmd`:\n    ```bash\n    sudo apt update\n    sudo apt install aicmd\n    ```\n\n## Usage Examples\n\nOnce installed, using `aicmd` is straightforward.\n\n1.  **Basic Usage:** To get a Linux command, simply type `aicmd` followed by your query in double quotes:\n    ```bash\n    aicmd \"how to list all files in the current directory, including hidden ones?\"\n    ```\n    `aicmd` will display the suggested command. It will then ask if you want to execute it (e.g., `Run? [y/N]`).\n\n2.  **First-Time Setup:** The very first time you run `aicmd`, it will prompt you to enter your Google Gemini API key. This key is securely stored in `~/.aicmd.env`. You can obtain a Gemini API key from the [Google AI Studio](https://aistudio.google.com/app/apikey).\n\n## How to Update the Gemini API Key\n\nIf you need to change or renew your Gemini API key, use the following command:\n\n```bash\naicmd --renew-key\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhaideryzai%2Faicmd-apt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhaideryzai%2Faicmd-apt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhaideryzai%2Faicmd-apt/lists"}