Merge origin/main into issue-244

Author: Sahilbhatane

AGENTS.md

@@ -0,0 +1,81 @@
+# Cortex Linux - AI Agent Guidelines
+
+## Project Overview
+
+Cortex Linux is an AI-native package manager for Debian/Ubuntu that understands natural language commands. It wraps `apt` with LLM intelligence to parse requests, detect hardware, resolve dependencies, and execute installations safely.
+
+**Repository**: https://github.com/cortexlinux/cortex
+**License**: Apache 2.0
+**Primary Language**: Python 3.10+
+
+## Quick Start
+
+```bash
+# Clone and setup
+git clone https://github.com/cortexlinux/cortex.git
+cd cortex
+python3 -m venv venv
+source venv/bin/activate
+pip install -e .
+
+# Configure API key
+echo 'ANTHROPIC_API_KEY=your-key-here' > .env
+
+# Verify installation
+cortex install nginx --dry-run
+```
+
+## Development Environment
+
+### Prerequisites
+- Python 3.10 or higher
+- Ubuntu 22.04+ or Debian 12+
+- Virtual environment (required)
+- Anthropic API key or OpenAI API key
+
+### Setup Commands
+```bash
+python3 -m venv venv
+source venv/bin/activate
+pip install -e .
+pip install -r requirements-dev.txt
+pytest tests/ -v
+```
+
+## Testing Instructions
+
+```bash
+# Run all tests
+pytest tests/ -v
+
+# Test dry-run (safe)
+cortex install nginx --dry-run
+
+# Test hardware detection
+cortex-detect-hardware
+```
+
+## Code Standards
+
+- Follow PEP 8
+- Type hints required
+- Docstrings for public APIs
+- >80% test coverage for PRs
+
+## Safety Requirements
+
+1. Dry-run by default for all installations
+2. No silent sudo
+3. Firejail sandboxing required
+4. Audit logging to ~/.cortex/history.db
+
+## PR Guidelines
+
+- Title format: [component] Description
+- All tests must pass
+- Documentation required for new features
+
+## Contact
+
+- Discord: https://discord.gg/uCqHvxjU83
+- Email: [email protected]

README_MCP.md

@@ -0,0 +1,47 @@
+# Cortex Linux MCP Server
+
+Connect any MCP-compatible AI (Claude, ChatGPT, Cursor, VS Code) to Cortex Linux.
+
+## Install
+
+```bash
+pip install cortex-mcp-server
+```
+
+## Configure Claude Desktop
+
+Add to `~/.config/claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "cortex-linux": {
+      "command": "cortex-mcp-server"
+    }
+  }
+}
+```
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| install_package | Install packages via natural language |
+| search_packages | Search package database |
+| get_history | View installation history |
+| rollback | Rollback previous installation |
+| detect_hardware | Detect GPU/CPU |
+| system_status | Get system status |
+
+## Safety
+
+- Dry-run by default
+- Explicit confirmation required for changes
+- Firejail sandboxing
+- Full audit logging
+
+## Links
+
+- [MCP Specification](https://modelcontextprotocol.io)
+- [AAIF](https://aaif.io)
+- [Discord](https://discord.gg/uCqHvxjU83)