[App] Claude Code UI – chat style interface for Claude code inside HA

Share your Projects!
,
1

[App] Claude Code UI – chat style interface for Claude code inside HA

I made an app that runs Claude Code as a chat UI inside Home Assistant. I wanted to use the power of Claude Code inside home assistant, but existing terminal UI based apps don’t work well on mobile devices. So I built my own (with Claude).

image
image860×1800 116 KB
image
image860×1440 82.8 KB

image
image860×1240 79.3 KB

What it does

  • Reads your entities, config, installed apps, and recent errors.
  • Writes and edits automations, scripts, templates, and dashboards (YAML and storage-mode).
  • Answers complex questions from history, statistics, and the logbook.
  • Tool calls needs your approval in ask mode. Permission modes: Ask, Plan, Auto, Accept edits, Bypass.
  • Entity names in its replies are links. Tap one to open it in HA.
  • Attach images, photos, or files to a message.
  • Optional ESPHome support: validate, compile, flash, and read device logs.

I started using the Claude Terminal App (GitHub - heytcass/home-assistant-addons · GitHub), but since I use HA mostly on my phone, I found the terminal interface clunky and certain features didn’t work or were very awkward. So I build this an alternative way to use Claude Code within HA.

Install

Add repository to your Home Assistant instance.

Or add it manually: Settings → Apps → Install app → ⋮ → Repositories, then add https://github.com/xionic/home-assistant-claude-code

You’ll need a Claude subscription, or API key to use this. It uses the Claude Code SDK underneath.

Before you use it

It can edit your config and run commands. Take a backup first.

Not affiliated with Anthropic. It’s a community project that uses Claude.

Full docs and screenshots:

Feedback and bug reports welcome.

2

Suggestion:
Add-ons have been renamed to Apps about a year ago now.

Add-ons no longer exist and building new Apps and using the words and links to the old way in the readme is very confusing for users wanting to try your stuff…

Please consider a wording revision.
A simpler approach may be to use the Create a link – My Home Assistant facility…

For instance, this install sequence doesn’t work:

And in your github repo:

To add this repository to your Home Assistant instance:

  1. Go to Settings → Add-ons → Add-on Store

and

GitHub - heytcass/home-assistant-addons · GitHub

Proofreading and testing the actual instructions that you copied from other sources to make sure things are right is a good best practice to follow. So is this: AI Policy | Home Assistant Developer Docs

3

Thanks for the feedback. I’ve changed the wording to Apps (they’re still add-ons in my head :laughing:). I updated the repo too, though the heytcass/home-assistant-addons you flagged is not mine, I was just referecing it.

I don’t see a way to update the post title sadly. Thanks for the poke on the AI Policy, point taken!

4

@nick.spargo32 - Love the idea! Lots of convergent evolution here. I similarly just released a similar app to this called brAIn. I’m thinking about making a repo tracker of all the AI powered HA tools. Would you mind if I include your repo in that?

5

Yeah sure!

brAIn looks pretty cool, I’ll have to try it out!