feat: add status-line configuration support

Add statusLine configuration support to environment YAML config:
- status-line.file: script path to download to user config directory
- status-line.padding: optional padding value for the status line

Python scripts are executed via uv run, other files are executed directly.

Author: alex-feel

scripts/setup_environment.py

@@ -3250,6 +3250,7 @@ def create_additional_settings(
     always_thinking_enabled: bool | None = None,
     company_announcements: list[str] | None = None,
     attribution: dict[str, str] | None = None,
+    status_line: dict[str, Any] | None = None,
 ) -> bool:
     """Create {command_name}-additional-settings.json with environment-specific settings.
 
@@ -3269,6 +3270,8 @@ def create_additional_settings(
         company_announcements: Optional list of company announcement strings
         attribution: Optional dict with 'commit' and 'pr' keys for custom attribution strings.
             Empty strings hide attribution. Takes precedence over include_co_authored_by.
+        status_line: Optional dict with 'file' key for status line script path and optional
+            'padding' key. The file is downloaded to ~/.claude/hooks/ and configured in settings.
 
     Returns:
         bool: True if successful, False otherwise.
@@ -3331,6 +3334,38 @@ def create_additional_settings(
         settings['companyAnnouncements'] = company_announcements
         info(f'Setting companyAnnouncements: {len(company_announcements)} announcement(s)')
 
+    # Add statusLine if explicitly set (None means not configured, leave as default)
+    if status_line is not None:
+        status_line_file = status_line.get('file')
+        if status_line_file:
+            # Build absolute path to the hook file in .claude/hooks/
+            # Strip query parameters from filename
+            clean_filename = status_line_file.split('?')[0] if '?' in status_line_file else status_line_file
+            filename = Path(clean_filename).name
+            hook_path = claude_user_dir / 'hooks' / filename
+            hook_path_str = hook_path.as_posix()
+
+            # Determine command based on file extension
+            if filename.lower().endswith(('.py', '.pyw')):
+                # Python script - use uv run
+                status_line_command = f'uv run --no-project --python 3.12 {hook_path_str}'
+            else:
+                # Other file - use path directly
+                status_line_command = hook_path_str
+
+            status_line_config: dict[str, Any] = {
+                'type': 'command',
+                'command': status_line_command,
+            }
+
+            # Add optional padding
+            padding = status_line.get('padding')
+            if padding is not None:
+                status_line_config['padding'] = padding
+
+            settings['statusLine'] = status_line_config
+            info(f'Setting statusLine: {filename}')
+
     # Handle hooks if present
     hook_events: list[dict[str, Any]] = []
 
@@ -4147,6 +4182,9 @@ def main() -> None:
         # Extract attribution configuration (new format, takes precedence over include-co-authored-by)
         attribution = config.get('attribution')
 
+        # Extract status_line configuration
+        status_line = config.get('status-line')
+
         # Extract claude-code-version configuration
         claude_code_version = config.get('claude-code-version')
         claude_code_version_normalized = None  # Default to latest
@@ -4316,6 +4354,11 @@ def main() -> None:
             # Step 13: Configure settings
             print()
             print(f'{Colors.CYAN}Step 13: Configuring settings...{Colors.NC}')
+            # Cast status_line for type safety
+            status_line_arg: dict[str, Any] | None = None
+            if status_line is not None and isinstance(status_line, dict):
+                status_line_arg = cast(dict[str, Any], status_line)
+
             create_additional_settings(
                 hooks,
                 claude_user_dir,
@@ -4327,6 +4370,7 @@ def main() -> None:
                 always_thinking_enabled,
                 company_announcements,
                 attribution,
+                status_line_arg,
             )
 
             # Step 14: Create launcher script
@@ -4390,6 +4434,15 @@ def main() -> None:
             print(f'   * Environment variables: {len(env_variables)} configured')
         if company_announcements:
             print(f'   * Company announcements: {len(company_announcements)} configured')
+        if status_line and isinstance(status_line, dict):
+            status_line_dict = cast(dict[str, Any], status_line)
+            status_line_file_val = status_line_dict.get('file', '')
+            if status_line_file_val and isinstance(status_line_file_val, str):
+                if '?' in status_line_file_val:
+                    clean_name = Path(status_line_file_val.split('?')[0]).name
+                else:
+                    clean_name = Path(status_line_file_val).name
+                print(f'   * Status line: {clean_name}')
         if os_env_variables:
             set_vars = sum(1 for v in os_env_variables.values() if v is not None)
             del_vars = sum(1 for v in os_env_variables.values() if v is None)

tests/test_setup_environment.py

@@ -1259,6 +1259,108 @@ def test_create_additional_settings_attribution_none_not_included(self):
 
             assert 'attribution' not in settings
 
+    def test_create_additional_settings_status_line_python(self):
+        """Test statusLine with Python script."""
+        with tempfile.TemporaryDirectory() as tmpdir:
+            claude_dir = Path(tmpdir)
+            # Create hooks directory
+            hooks_dir = claude_dir / 'hooks'
+            hooks_dir.mkdir(parents=True, exist_ok=True)
+
+            status_line = {
+                'file': 'statusline.py',
+                'padding': 0,
+            }
+
+            result = setup_environment.create_additional_settings(
+                {},
+                claude_dir,
+                'test-env',
+                status_line=status_line,
+            )
+
+            assert result is True
+            settings_file = claude_dir / 'test-env-additional-settings.json'
+            settings = json.loads(settings_file.read_text())
+
+            assert 'statusLine' in settings
+            assert settings['statusLine']['type'] == 'command'
+            assert 'uv run' in settings['statusLine']['command']
+            assert 'statusline.py' in settings['statusLine']['command']
+            assert settings['statusLine']['padding'] == 0
+
+    def test_create_additional_settings_status_line_shell(self):
+        """Test statusLine with shell script."""
+        with tempfile.TemporaryDirectory() as tmpdir:
+            claude_dir = Path(tmpdir)
+            hooks_dir = claude_dir / 'hooks'
+            hooks_dir.mkdir(parents=True, exist_ok=True)
+
+            status_line = {
+                'file': 'statusline.sh',
+            }
+
+            result = setup_environment.create_additional_settings(
+                {},
+                claude_dir,
+                'test-env',
+                status_line=status_line,
+            )
+
+            assert result is True
+            settings_file = claude_dir / 'test-env-additional-settings.json'
+            settings = json.loads(settings_file.read_text())
+
+            assert 'statusLine' in settings
+            assert settings['statusLine']['type'] == 'command'
+            assert 'uv run' not in settings['statusLine']['command']
+            assert 'statusline.sh' in settings['statusLine']['command']
+            assert 'padding' not in settings['statusLine']
+
+    def test_create_additional_settings_status_line_none_not_included(self):
+        """Test statusLine not included when None."""
+        with tempfile.TemporaryDirectory() as tmpdir:
+            claude_dir = Path(tmpdir)
+
+            result = setup_environment.create_additional_settings(
+                {},
+                claude_dir,
+                'test-env',
+                status_line=None,
+            )
+
+            assert result is True
+            settings_file = claude_dir / 'test-env-additional-settings.json'
+            settings = json.loads(settings_file.read_text())
+
+            assert 'statusLine' not in settings
+
+    def test_create_additional_settings_status_line_with_query_params(self):
+        """Test statusLine file with query parameters stripped."""
+        with tempfile.TemporaryDirectory() as tmpdir:
+            claude_dir = Path(tmpdir)
+            hooks_dir = claude_dir / 'hooks'
+            hooks_dir.mkdir(parents=True, exist_ok=True)
+
+            status_line = {
+                'file': 'statusline.py?ref_type=heads',
+            }
+
+            result = setup_environment.create_additional_settings(
+                {},
+                claude_dir,
+                'test-env',
+                status_line=status_line,
+            )
+
+            assert result is True
+            settings_file = claude_dir / 'test-env-additional-settings.json'
+            settings = json.loads(settings_file.read_text())
+
+            assert 'statusLine' in settings
+            assert '?' not in settings['statusLine']['command']
+            assert 'statusline.py' in settings['statusLine']['command']
+
 
 class TestCreateLauncherScript:
     """Test launcher script creation."""