push

Co-authored-by: Copilot <copilot@github.com>

README.md

@@ -1,3 +1,35 @@
-# tai
+# tai — Linux AI Troubleshooting Agent
 
-Linux AI driven troubleshooting agent.
+`tai` is an agentic AI-driven troubleshooting tool for Linux systems. It autonomously investigates issues on remote hosts via SSH, analyzes relevant logs and configuration files, and provides a clear diagnosis along with suggested remediation steps — all without making any changes to the target system.
+
+## Overview
+
+Given a problem description and a target hostname, `tai` connects to the remote system over SSH, gathers relevant data (logs, configuration files, service status, etc.), and uses a locally-hosted AI model to reason about the root cause and recommend solutions.
+
+The agent operates in **read-only mode at all times**. It will never modify the target system under any circumstances — all suggestions are presented to the human troubleshooter for review and action.
+
+## Supported Distributions
+
+- Ubuntu
+- Debian
+- RHEL
+- Rocky Linux
+
+## Example Workflow
+
+A troubleshooter receives a ticket reporting that the Apache service on a remote server has failed to start. They provide `tai` with:
+
+1. The ticket description or error message
+2. The hostname of the affected system
+3. Any relevant directories to focus on
+
+`tai` then connects to the host, reads through system logs, service configurations, and any other related files, and returns a structured analysis of the likely cause along with recommended next steps.
+
+## Suggested Tooling
+
+| Component | Tool |
+|-----------|------|
+| AI inference backend | [vLLM](https://github.com/vllm-project/vllm) |
+| Model | `gemma4:a4b` |
+
+> **Note:** A suitable implementation language for this project is yet to be determined.