{"id":28510803,"url":"https://github.com/jnarusis/ai-toolkit-cli","last_synced_at":"2025-07-04T22:32:29.943Z","repository":{"id":297649530,"uuid":"997423540","full_name":"jnarusis/ai-toolkit-cli","owner":"jnarusis","description":"A practical CLI toolkit for generating and explaining Bash and PowerShell scripts, with built-in concept explainers for Linux and Windows system administration.","archived":false,"fork":false,"pushed_at":"2025-06-06T15:40:51.000Z","size":3,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-06T16:40:45.959Z","etag":null,"topics":["automation","cli-tools","openai","portfolio-project","python","scripting","sysadmin"],"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/jnarusis.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":"2025-06-06T13:57:31.000Z","updated_at":"2025-06-06T15:40:53.000Z","dependencies_parsed_at":"2025-06-06T21:00:26.627Z","dependency_job_id":null,"html_url":"https://github.com/jnarusis/ai-toolkit-cli","commit_stats":null,"previous_names":["jnarusis/ai-toolkit-cli"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jnarusis/ai-toolkit-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jnarusis%2Fai-toolkit-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jnarusis%2Fai-toolkit-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jnarusis%2Fai-toolkit-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jnarusis%2Fai-toolkit-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jnarusis","download_url":"https://codeload.github.com/jnarusis/ai-toolkit-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jnarusis%2Fai-toolkit-cli/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263628013,"owners_count":23490894,"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":["automation","cli-tools","openai","portfolio-project","python","scripting","sysadmin"],"created_at":"2025-06-08T23:06:14.210Z","updated_at":"2025-07-04T22:32:29.930Z","avatar_url":"https://github.com/jnarusis.png","language":"Python","readme":"AI Toolkit CLI\n==============\n\nThis is a modular, GPT-powered command-line toolkit for scripting, system administration, and IT learning. It supports both Linux and Windows environments, and includes an interactive tutor mode to guide users through homelab builds and troubleshooting tasks.\n\nDesigned for self-directed IT learners, homelab builders, and sysadmin professionals who want rapid, explainable help at the command line.\n\nFeatures\n--------\n\n- Generate Bash scripts from plain-language prompts  \n- Break down existing Bash scripts line by line  \n- Explain Linux and DevOps concepts  \n- Generate PowerShell scripts from natural language  \n- Break down PowerShell scripts line by line  \n- Explain Windows sysadmin concepts (GPO, services, registry, etc.)  \n- NEW: AI Tutor Mode – ask any sysadmin question in natural language  \n- Modular and documented – easily extensible with new tools or workflows  \n\nReal-World Use\n--------------\n\nI used this assistant to help build my full Windows Server Homelab, step by step. The AI Tutor helped me understand and implement Active Directory, Group Policy, DHCP, WSUS, and more.\n\nIt can also guide users through setting up a Linux lab, managing scripts, or debugging tasks interactively.\n\nSetup\n-----\n\n1. Clone the repository:\n\n       git clone https://github.com/jnarusis/ai-toolkit-cli.git\n       cd ai-toolkit-cli\n\n2. Create and activate a virtual environment:\n\n   **Windows:**\n\n       python -m venv venv\n       .\\venv\\Scripts\\activate\n\n   **Linux/macOS:**\n\n       python3 -m venv venv\n       source venv/bin/activate\n\n3. Install requirements:\n\n       pip install -r requirements.txt\n\n4. Set your OpenAI API key:\n\n   - Copy `.env.example` to `.env`\n   - Replace with your key:\n\n         OPENAI_API_KEY=your-key-here\n\n5. Run the CLI tool:\n\n       python main.py\n\nMenu Overview\n-------------\n\n       === AI CLI Toolkit ===\n       1. Generate a Bash script\n       2. Break down a Bash script\n       3. Explain a Linux/DevOps concept\n       4. Generate a PowerShell script\n       5. Break down a PowerShell script\n       6. Explain a Windows/PowerShell concept\n       7. AI Tutor Mode (Ask GPT)\n       8. Exit\n\nProject Structure\n-----------------\n\n    ai-toolkit-cli/\n    ├── tools/\n    │   ├── generate_bash.py\n    │   ├── explain_bash.py\n    │   ├── explain_linux.py\n    │   ├── generate_powershell.py\n    │   ├── explain_powershell.py\n    │   ├── explain_windows.py\n    │   ├── tutor_mode.py          # GPT-powered AI tutor\n    │   └── tutorial_mode.py       # Static walkthrough (Windows Homelab)\n    │\n    ├── shared/\n    │   └── gpt_helper.py          # Shared API call logic (optional)\n    │\n    ├── .env.example\n    ├── requirements.txt\n    ├── main.py\n    └── README.md\n\nLicense\n-------\n\nThis project is licensed under the MIT License.","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjnarusis%2Fai-toolkit-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjnarusis%2Fai-toolkit-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjnarusis%2Fai-toolkit-cli/lists"}