Claude Terminal Prowine for Home Assistant

An enhanced Home Assistant app that integrates Anthropic's Claude Code CLI with persistent package management and advanced features.

Recommended Plugins

For an enhanced Claude Code experience with Home Assistant, we recommend installing the Claude Home Assistant Plugins:

https://github.com/ESJavadex/claude-homeassistant-plugins

These plugins provide Claude Code with specialized tools and context for Home Assistant development, including entity management, automation helpers, and more.

Installation

Run this command inside Claude Terminal Prowine:

npx claude-plugins install @ESJavadex/claude-homeassistant-plugins/homeassistant-config

This creates a CLAUDE.md file in your Home Assistant config directory with context and instructions tailored for Home Assistant development.

Fork Attribution

This project is a fork built upon work from two repositories:

Repository	Author	Description
heytcass/home-assistant-addons	Tom Cassady (@heytcass)	Original Claude Terminal app
ESJavadex/claude-code-ha	Javier Santos (@esjavadex)	Enhanced fork with persistent packages

This fork: @owine - personal use

Features from Upstream

• Image Paste Support: Upload images via paste (Ctrl+V), drag-drop, or upload button for Claude analysis
• Persistent Package Management: Install system and Python packages that survive reboots
• Auto-install Configuration: Configure packages to auto-install on startup
• Native Claude Installation: Uses Anthropic's official installer
• GitHub CLI: Pre-installed with persistent authentication

This project maintains the same MIT license as the original.

Installation

To add this repository to your Home Assistant instance:

1. Go to Settings → Apps → App Store
2. Click the three dots menu in the top right corner
3. Select Repositories
4. Add the URL: https://github.com/owine/claude-terminal-home-assistant
5. Click Add

Then install the Claude Terminal Prowine app and start it. See DOCS.md for the full step-by-step install and first-run guide.

Apps

Claude Terminal Prowine

A web-based terminal interface with Claude Code CLI pre-installed and enhanced package management. This app provides a terminal environment directly in your Home Assistant dashboard, allowing you to use Claude's powerful AI capabilities for coding, automation, and configuration tasks.

Core Features

• Web terminal access through your Home Assistant UI
• Pre-installed Claude Code CLI that launches automatically
• Direct access to your Home Assistant config directory (/config)
• Works with zero configuration out of the box (uses OAuth), with optional settings available
• Install as App (PWA): Add to your iOS/Android home screen for quick access
• Access to Claude's complete capabilities including:
  • Code generation and explanation
  • Debugging assistance
  • Home Assistant automation help
  • Learning resources

Enhanced Features (Pro)

• Image Paste Support: Paste (Ctrl+V), drag-drop, or upload images for Claude analysis
  • Lightweight service (~10MB RAM, ARM-compatible)
  • Supports JPEG, PNG, GIF, WebP, SVG (10MB limit)
  • Persistent storage in /data/images/
  • Perfect for OCR, image analysis, screenshot debugging
• Persistent Package Management: Install packages that survive container restarts
• Auto-install Packages: Configure APK and pip packages to auto-install on startup
• Python Virtual Environment: Isolated Python environment for packages
• Simple Commands: Use persist-install for easy package management
• Unrestricted Mode: Option to run Claude with --dangerously-skip-permissions for full file access

Configuration Options

The app works with zero configuration out of the box. Eight optional settings are available (auto-launch, unrestricted mode, HA MCP, tmux mouse mode, persistent APK/pip packages, and Docker access). See the full options reference in DOCS.md.

Documentation

Community Tools

Tools built by the community to enhance Claude Terminal:

• ha-ws-client-go by @schoolboyqueue - Lightweight Go CLI for Home Assistant WebSocket API. Gives Claude direct access to entity states, service calls, automation traces, and real-time monitoring. Single binary, no dependencies.

Support

If you have any questions or issues with this app, please create an issue in this repository.

Credits

• Original Creator: Tom Cassady (@heytcass) - Created the initial Claude Terminal app
• Enhanced By: Javier Santos (@esjavadex) - Added persistent package management and enhancements

Integrated Contributions:

• Petter Sandholdt (@petterl) - tmux session persistence (PR #46)
• Brian Egge (@brianegge) - ha-mcp Home Assistant MCP integration (PR #49)

This app was created and enhanced with the assistance of Claude Code itself!

License

This repository is licensed under the MIT License - see the LICENSE file for details.