# AGENTS.md

## Tooling
- Flutter SDK path: `C:\tools\flutter\bin\flutter.bat`
- On Windows, use the absolute Flutter path instead of relying on `PATH`.
- Prefer running Flutter and Dart work from the repository root or the app directory with the absolute Flutter path.

## Windows Shell Setup
- Before running commands, initialize the terminal as UTF-8:
  - `chcp 65001`
  - `[Console]::InputEncoding = [System.Text.UTF8Encoding]::new($false)`
  - `[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)`
  - `$OutputEncoding = [System.Text.UTF8Encoding]::new($false)`
  - `$env:PYTHONUTF8 = '1'`
  - `$env:PYTHONIOENCODING = 'utf-8'`

## Common Commands
- Run all mobile app tests:
  - `C:\tools\flutter\bin\flutter.bat test`
- Run a targeted Flutter test:
  - `C:\tools\flutter\bin\flutter.bat test test/widget_test.dart`
- Run Windows agent tests:
  - `dotnet test apps/windows_agent/TermRemoteCtl.Agent.sln`

## Encoding Rules
- All source, config, Markdown, JSON, YAML, TOML, and script files must use UTF-8 without BOM.
- Do not rely on terminal rendering alone to diagnose encoding issues.
- Always read and write text files explicitly as UTF-8 when tooling requires an encoding choice.