Initial release: HA Cursor Agent v1.0.0

AI Agent API for Home Assistant - enables Cursor AI to autonomously manage HA configuration.

Features:
- 📁 File Management: Read/write/list configuration files
- 🏠 HA Integration: Full REST API access, entity queries
- 🔧 Component Management: Create/delete helpers, automations, scripts
- 💾 Git Versioning: Automatic backup, rollback, commit history
- 📊 Monitoring: Agent logs, operation history, health checks

29 API endpoints with Swagger UI documentation.
Install as Home Assistant Add-on in 5 minutes.

Repository: https://github.com/Coolver/home-assistant-cursor-agent
License: MIT

Author: Coolver

.github/workflows/builder.yaml

@@ -0,0 +1,31 @@
+name: Builder
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    name: Build add-on
+    steps:
+      - name: Checkout the repository
+        uses: actions/checkout@v4
+      
+      - name: Login to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+      
+      - name: Build add-on
+        uses: home-assistant/builder@master
+        with:
+          args: |
+            --all \
+            --target ha_cursor_agent
+

.gitignore

@@ -0,0 +1,16 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+*.egg-info/
+dist/
+build/
+.env
+.venv
+venv/
+*.log
+.DS_Store
+.vscode/
+.idea/
+

CHANGELOG.md

@@ -0,0 +1,63 @@
+# Changelog
+
+## [1.0.0] - 2025-11-03
+
+### Added
+- Initial release
+- FastAPI REST API
+- Files API (read/write/list/append/delete)
+- Entities API (list/state/services)
+- Helpers API (create/delete)
+- Automations API (create/delete/list)
+- Scripts API (create/delete/list)
+- System API (reload/check_config/restart)
+- Backup API (commit/rollback/history/diff)
+- Logs API (get/clear)
+- Git versioning integration
+- Automatic backups before modifications
+- Swagger UI documentation
+- Authentication via HA token
+- Comprehensive logging
+- Health check endpoint
+
+### Features
+- ✅ Full file system access to /config
+- ✅ CRUD operations for helpers, automations, scripts
+- ✅ Git-based version control
+- ✅ Automatic backup/rollback
+- ✅ Configuration validation
+- ✅ Component reload without restart
+- ✅ Interactive API documentation
+- ✅ Audit logs
+
+### Security
+- Path validation (restricted to /config)
+- Token-based authentication
+- Operation logging
+- Safe rollback mechanism
+
+---
+
+## Future Plans
+
+### [1.1.0] - Planned
+- WebSocket support for real-time updates
+- Bulk operations API
+- Template validation before applying
+- Dashboard management API
+- Lovelace card creation
+- Integration management
+- Device management
+
+### [1.2.0] - Planned
+- AI-friendly natural language API
+- Auto-fix configuration errors
+- Dependency detection
+- Impact analysis before changes
+- Automated testing
+- Performance optimization
+
+---
+
+*Stay tuned for updates!*
+