From 2c3cc623ff4e0a0f3f90b29a75bfe29dab65b67c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Martin=20Bok=C5=A1a?= Date: Fri, 17 Jul 2026 15:11:05 +0200 Subject: [PATCH 1/3] Add remote_control add-on options (#28) --- claude-terminal/config.yaml | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/claude-terminal/config.yaml b/claude-terminal/config.yaml index 38c6e09a..a326117e 100644 --- a/claude-terminal/config.yaml +++ b/claude-terminal/config.yaml @@ -1,7 +1,7 @@ --- name: "Claude Terminal Pro" description: "Enhanced terminal interface for Anthropic's Claude Code CLI with persistent auth, package management, and image paste support. Fork of heytcass/home-assistant-addons" -version: "2.0.13" +version: "2.0.14" slug: "claude_terminal_pro" init: false @@ -32,6 +32,8 @@ ports_description: # Add-on configuration options options: auto_launch_claude: true + remote_control: false + remote_control_session_name: "" tmux_mouse: false dangerously_skip_permissions: false persistent_apk_packages: [] @@ -41,6 +43,8 @@ options: schema: auto_launch_claude: bool? + remote_control: bool? + remote_control_session_name: str? tmux_mouse: bool? dangerously_skip_permissions: bool? persistent_apk_packages: From 9d1fc212a50d883d3a75c235e6cbbb9d22029b07 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Martin=20Bok=C5=A1a?= Date: Fri, 17 Jul 2026 15:18:13 +0200 Subject: [PATCH 2/3] Wire --remote-control into get_claude_launch_command (#28) --- claude-terminal/run.sh | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/claude-terminal/run.sh b/claude-terminal/run.sh index fb7c220b..aaf06e33 100644 --- a/claude-terminal/run.sh +++ b/claude-terminal/run.sh @@ -393,11 +393,15 @@ auto_install_packages() { get_claude_launch_command() { local auto_launch_claude local dangerously_skip_permissions + local remote_control + local remote_control_session_name local claude_flags="" # Get configuration values auto_launch_claude=$(bashio::config 'auto_launch_claude' 'true') dangerously_skip_permissions=$(bashio::config 'dangerously_skip_permissions' 'false') + remote_control=$(bashio::config 'remote_control' 'false') + remote_control_session_name=$(bashio::config 'remote_control_session_name' '') # Build Claude flags if [ "$dangerously_skip_permissions" = "true" ]; then @@ -405,6 +409,25 @@ get_claude_launch_command() { bashio::log.warning "Claude will run with --dangerously-skip-permissions (unrestricted file access)" fi + # Remote Control: start the auto-launched interactive session already paired + # with claude.ai/code and the Claude mobile app (same as `claude --remote-control`), + # so a phone or browser can drive it without opening the web terminal first. + # Only affects the auto-launch path below; the session picker builds its own + # commands. Needs a claude.ai OAuth login and Claude Code v2.1.51+, so it does + # nothing on the ARMv7 image that pins the portable 1.0.128 release. + if [ "$remote_control" = "true" ]; then + claude_flags="${claude_flags:+${claude_flags} }--remote-control" + if [ -n "$remote_control_session_name" ]; then + # printf %q shell-quotes the name so spaces (and any other special + # characters) survive the eval in the tmux wrapper as a single argument. + claude_flags="${claude_flags} $(printf '%q' "$remote_control_session_name")" + fi + bashio::log.info "Remote Control enabled: Claude will start with --remote-control" + if [ "$auto_launch_claude" != "true" ]; then + bashio::log.warning "remote_control is set but has no effect while auto_launch_claude is false" + fi + fi + if [ "$auto_launch_claude" = "true" ]; then # Auto-launch Claude first, then fall back to session picker on exit if [ -f /usr/local/bin/claude-session-picker ]; then From 4b47e3a2fdb201854621456d28575a1880807a0a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Martin=20Bok=C5=A1a?= Date: Fri, 17 Jul 2026 15:20:35 +0200 Subject: [PATCH 3/3] Document the remote_control option in DOCS.md (#28) --- claude-terminal/DOCS.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/claude-terminal/DOCS.md b/claude-terminal/DOCS.md index 5c869aa8..72004335 100644 --- a/claude-terminal/DOCS.md +++ b/claude-terminal/DOCS.md @@ -26,6 +26,14 @@ The add-on offers several configuration options: - When enabled, Claude starts automatically when you open the terminal - When disabled, shows an interactive session picker menu +### Remote Control +- **Default**: `remote_control: false` +- When enabled, the auto-launched Claude session starts with the `--remote-control` flag, pairing it with [claude.ai/code](https://claude.ai/code) and the Claude mobile app so you can drive the session from your phone, tablet, or another browser without opening the web terminal first (equivalent to running `claude --remote-control`) +- Only applies while `auto_launch_claude: true`; it has no effect on the interactive session picker +- Optionally set `remote_control_session_name` to give the session a fixed title in the session list; leave it empty to let Claude auto-generate one +- **Requires** a claude.ai OAuth login (API keys are not supported) and Claude Code v2.1.51 or later. It is therefore not available on the ARMv7 build, which pins the portable `1.0.128` release +- See Anthropic's [Remote Control guide](https://code.claude.com/docs/en/remote-control) for details + ### Dangerously Skip Permissions - **Default**: `false` - When enabled, Claude runs with `--dangerously-skip-permissions` flag @@ -56,6 +64,8 @@ The add-on offers several configuration options: **Example Configuration**: ```yaml auto_launch_claude: false +remote_control: false +remote_control_session_name: "" tmux_mouse: false dangerously_skip_permissions: true persistent_apk_packages: