Gemini Terminal for Home Assistant

Bring the power of Google's Gemini CLI directly to your Home Assistant dashboard!

Gemini Terminal provides an AI-driven, persistent web terminal pre-configured with the Home Assistant MCP (ha-mcp) server, giving Gemini native access to your smart home environment.

---

🚀 Key Features

• Google Gemini CLI Integration: A full-featured web terminal with the official Gemini CLI pre-installed.
• Native Home Assistant Control: Thanks to the integrated ha-mcp server, Gemini can read states, call services, and interact with your entities natively.
• Session Persistence: Built-in tmux support means you can navigate away or refresh without losing your terminal session or AI conversation.
• Smart Environment Context: Automatically creates a GEMINI.md file loaded with system info, architecture, and recent logs to ground Gemini in your specific setup.
• Seamless Authentication: Configure your GEMINI_API_KEY straight from the Home Assistant add-on UI.
• Direct Config Access: Boots directly into your /config directory for immediate YAML editing and troubleshooting.

📦 Installation

We've made installation as simple as possible.

One-Click Install

Click the button below to add this repository directly to your Home Assistant instance:

Manual Install

1. In Home Assistant, go to Settings → Add-ons → Add-on Store.
2. Click the ⋮ menu in the top right corner and select Repositories.
3. Add the following URL: https://github.com/oded996/gemini-cli-home-assistant-addons
4. Find Gemini Terminal in the add-on store and click Install.

⚙️ Configuration & Usage

1. After installation, go to the add-on's Configuration tab.
2. Enter your GEMINI_API_KEY (highly recommended for seamless startup).
3. Start the add-on.
4. Click Open Web UI (or enable the "Show in sidebar" toggle) to access your terminal!

For advanced configurations, check out the Full Add-on Documentation.

📖 Documentation & Logs

• Full Add-on Documentation
• Changelog

🤝 Credits & Inspiration

This project was built on the incredible work of others in the Home Assistant community:

• Tom Cassady (@heytcass): For creating the original Claude Terminal for Home Assistant which served as the foundation for this project.
• Magnus Overli (@magnusoverli): For OpenCode for Home Assistant, which provided the inspiration and architectural reference for our recent stability refactors.

📜 License

This repository is licensed under the MIT License - see the LICENSE file for details.
Note: The Gemini CLI tool itself is subject to Google's Terms of Service.