{"id":51285193,"url":"https://github.com/hossbit/comai-linux-assistant","last_synced_at":"2026-06-30T05:00:36.607Z","repository":{"id":367242236,"uuid":"1279922334","full_name":"hossbit/comai-linux-assistant","owner":"hossbit","description":"Local AI Linux terminal assistant written in Bash. Explain commands, analyze files and logs, and use local LLMs or OpenAI-compatible APIs.","archived":false,"fork":false,"pushed_at":"2026-06-25T23:39:09.000Z","size":32,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-26T01:11:39.723Z","etag":null,"topics":["ai-assistant","bash","bash-script","cli","command-line-tool","devops","linux","linux-assistant","llama-cpp","llm","local-ai","local-llm","log-analysis","open-source","openai","openai-api","shell-assistant","system-administration","terminal","terminal-assistant"],"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/hossbit.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-25T05:55:43.000Z","updated_at":"2026-06-25T23:39:14.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/hossbit/comai-linux-assistant","commit_stats":null,"previous_names":["hossbit/localcomai","hossbit/comai-linux-assistant"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/hossbit/comai-linux-assistant","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hossbit%2Fcomai-linux-assistant","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hossbit%2Fcomai-linux-assistant/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hossbit%2Fcomai-linux-assistant/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hossbit%2Fcomai-linux-assistant/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hossbit","download_url":"https://codeload.github.com/hossbit/comai-linux-assistant/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hossbit%2Fcomai-linux-assistant/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34952850,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-30T02:00:05.919Z","response_time":92,"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":["ai-assistant","bash","bash-script","cli","command-line-tool","devops","linux","linux-assistant","llama-cpp","llm","local-ai","local-llm","log-analysis","open-source","openai","openai-api","shell-assistant","system-administration","terminal","terminal-assistant"],"created_at":"2026-06-30T05:00:36.029Z","updated_at":"2026-06-30T05:00:36.588Z","avatar_url":"https://github.com/hossbit.png","language":"Shell","funding_links":["https://buymeacoffee.com/mirhh"],"categories":[],"sub_categories":[],"readme":"# ComAI - Linux Terminal AI Assistant\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/hossbit/mirassets/main/images/comai-hero.png\" alt=\"ComAI local AI assistant for Linux\" width=\"900\"\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n![Linux](https://img.shields.io/badge/Linux-supported-FCC624)\n![Bash](https://img.shields.io/badge/Bash-shell-4EAA25)\n![Local AI](https://img.shields.io/badge/Local%20AI-supported-2E7D32)\n![Ollama](https://img.shields.io/badge/Ollama-supported-black)\n![LM Studio](https://img.shields.io/badge/LM%20Studio-supported-1F6FEB)\n![OpenAI](https://img.shields.io/badge/OpenAI-supported-10A37F)\n![License](https://img.shields.io/badge/license-MIT-green)\n[![Wiki](https://img.shields.io/badge/Wiki-documentation-blueviolet)](https://github.com/hossbit/comai-linux-assistant-wiki)\n\n\u003c/div\u003e\n\n**ComAI** is a Bash-powered AI assistant for your Linux terminal.\n\nUse it to ask Linux questions, explain commands before you run them, inspect\nfiles, scan logs, and talk to local AI, Ollama, or OpenAI without leaving your\nshell. ComAI is the client; LocalAI is only one optional backend.\n\n## Why Use It\n\n- Works from any terminal with the simple `comai` command.\n- Supports LocalAI, Ollama, LM Studio, llama.cpp server, OpenAI, and other OpenAI-compatible APIs.\n- Understands files and logs with `-f`.\n- Keeps setup and provider checks visible with `comai status`.\n- Installs as a user-space tool under `~/localcomai`.\n\n## Install\n\nOne-line install:\n\n```bash\ncurl -fsSL https://hossbit.github.io/comai/install.sh | bash\n```\n\nCustom install directory:\n\n```bash\ncurl -fsSL https://hossbit.github.io/comai/install.sh | COMAI_INSTALL_DIR=\"$HOME/apps/comai\" bash\n```\n\nManual install:\n\n```bash\ngit clone https://github.com/hossbit/comai-linux-assistant.git\ncd comai-linux-assistant\nchmod +x scripts/install.sh\n./scripts/install.sh\n```\n\nThen run:\n\n```bash\ncomai status\n```\n\n## First Commands\n\n```bash\ncomai explain chmod 755\ncomai how do I find files larger than 1GB?\ncomai do you see any error? -f application.log\ncomai ollama hi\ncomai lmstudio hi\ncomai gpt hi\n```\n\nLocal mode is the default. Use `comai ollama ...` for Ollama,\n`comai lmstudio ...` for LM Studio, and `comai gpt ...` for OpenAI.\n\n## Main Commands\n\n```bash\ncomai setup       # Configure provider, API, and model\ncomai ask         # Ask one question\ncomai chat        # Start an interactive conversation\ncomai explain     # Explain a command, error, or output\ncomai analyze     # Analyze logs, files, or piped output\ncomai status      # Show provider status and connections\ncomai provider    # Show active and available providers\ncomai models      # List models from all providers\ncomai config      # View, get, or edit settings\ncomai history     # Show previous conversations\ncomai start       # Start the optional LocalAI helper service\ncomai stop        # Stop the optional LocalAI helper service\ncomai restart     # Restart the optional LocalAI helper service\n```\n\n## Providers\n\nComAI supports:\n\n- `local`: any OpenAI-compatible local server, default `http://127.0.0.1:11435`\n- `ollama`: local Ollama API, default `http://127.0.0.1:11434`\n- `lmstudio`: LM Studio local server, default `http://127.0.0.1:1234`\n- `openai`: OpenAI API with `OPENAI_API_KEY` or `providers.openai.api_key`\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/hossbit/local-ai-server\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/hossbit/mirassets/main/images/local-ai-server.png\" alt=\"Local AI Server\" width=\"300\"\u003e\n    \u003cbr\u003e\n    \u003cstrong\u003ehossbit/local-ai-server\u003c/strong\u003e\n  \u003c/a\u003e\n  \u003cbr\u003e\n  OpenAI-compatible Linux local AI backend for the \u003ccode\u003elocal\u003c/code\u003e provider.\n\u003c/div\u003e\n\nCheck providers:\n\n```bash\ncomai status\ncomai models\ncomai provider\n```\n\n## Files And Logs\n\n```bash\ncomai explain this script -f install.sh\ncomai summarize this config -f nginx.conf\ncomai is this service healthy? -f service.log\n```\n\nComAI service/status logs are written under:\n\n```bash\n~/localcomai/logs/comai.log\n```\n\n## Documentation\n\nFull documentation lives in the wiki:\n\n- [Quick Start](https://github.com/hossbit/comai-linux-assistant-wiki/blob/main/Quick-Start.md)\n- [Installation](https://github.com/hossbit/comai-linux-assistant-wiki/blob/main/Installation.md)\n- [Providers](https://github.com/hossbit/comai-linux-assistant-wiki/blob/main/Providers.md)\n- [Configuration](https://github.com/hossbit/comai-linux-assistant-wiki/blob/main/Configuration.md)\n- [ComAI + LocalAI](https://github.com/hossbit/comai-linux-assistant-wiki/blob/main/ComAI-and-LocalAI.md)\n- [Local AI Service](https://github.com/hossbit/comai-linux-assistant-wiki/blob/main/Local-AI-Service.md)\n- [File and Log Analysis](https://github.com/hossbit/comai-linux-assistant-wiki/blob/main/File-and-Log-Analysis.md)\n- [Troubleshooting](https://github.com/hossbit/comai-linux-assistant-wiki/blob/main/Troubleshooting.md)\n- [Uninstall](https://github.com/hossbit/comai-linux-assistant-wiki/blob/main/Uninstall.md)\n\n## Requirements\n\n```text\nbash curl jq find sort head sed awk grep wc tr readlink date systemctl\n```\n\nOptional:\n\n```text\nfile numfmt git\n```\n\n## Support\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://buymeacoffee.com/mirhh\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/hossbit/mirassets/main/images/bmc-button.png\" alt=\"Buy me a coffee\" width=\"300\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhossbit%2Fcomai-linux-assistant","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhossbit%2Fcomai-linux-assistant","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhossbit%2Fcomai-linux-assistant/lists"}