agentworks-cli 0.2.1__tar.gz

agentworks_cli-0.2.1/.gitignore

@@ -0,0 +1,69 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+dist/
+build/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+
+# uv (cli/uv.lock is committed for reproducible CI builds)
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Rulesync
+rulesync.local.jsonc
+rulesync.lock
+
+# Rulesync - generated output (regenerate with: npx rulesync generate)
+CLAUDE.md
+.claude
+.claudeignore
+.mcp.json
+.cursor/
+.cursorrules
+.cursorignore
+.github/*
+!.github/workflows
+!.github/ISSUE_TEMPLATE
+!.github/PULL_REQUEST_TEMPLATE.md
+.copilotignore
+AGENTS.md
+GEMINI.md
+.gemini/
+.geminiignore
+.windsurfrules
+.clinerules/
+.roo/
+.codex/
+
+# Tmux
+.tmuxinator.yml
+
+# Secrets / env files
+*.env*
+
+# OS
+.DS_Store
+Thumbs.db
+
+# mypy
+.mypy_cache/
+
+# ruff
+.ruff_cache/
+
+# pytest
+.pytest_cache/
+htmlcov/
+.coverage

agentworks_cli-0.2.1/.python-version

@@ -0,0 +1 @@
+3.12

agentworks_cli-0.2.1/CHANGELOG.md

@@ -0,0 +1,346 @@
+# Changelog
+
+## [0.2.1](https://github.com/WayfarerLabs/agentworks/compare/v0.2.0...v0.2.1) (2026-05-27)
+
+
+### Bug Fixes
+
+* rename PyPI distribution to agentworks-cli ([3461823](https://github.com/WayfarerLabs/agentworks/commit/3461823a7f11d04fcdf1fd86dce76d6894659014))
+* rename PyPI distribution to agentworks-cli ([8b4e0a9](https://github.com/WayfarerLabs/agentworks/commit/8b4e0a90808b5e7421e71d7fc9e52e95470daff9))
+
+## [0.2.0](https://github.com/WayfarerLabs/agentworks/compare/v0.1.0...v0.2.0) (2026-05-27)
+
+
+### Features
+
+* add --no-status flag to task list for fast completions ([d025717](https://github.com/WayfarerLabs/agentworks/commit/d025717bdf9a2ef074850034a2ae463b27f82a85))
+* add (mostly idempotent) agent reinit command to cli ([3c62062](https://github.com/WayfarerLabs/agentworks/commit/3c62062f7b0b4d57f922940e97bbdc64e201de17))
+* add a proper claude plugin option for installing nerf tools ([b35b733](https://github.com/WayfarerLabs/agentworks/commit/b35b7338ac9891108fee017e3f91a8b28133e032))
+* add agent exec command ([17dad70](https://github.com/WayfarerLabs/agentworks/commit/17dad70aaebb5fed0cff82a649d96792add803ac))
+* add agent exec command for non-interactive remote execution as agent user ([1dabed9](https://github.com/WayfarerLabs/agentworks/commit/1dabed9d00773c9158af2317b033ae34b90c22be))
+* add agent socket infrastructure and refactor task session creation ([ea95339](https://github.com/WayfarerLabs/agentworks/commit/ea95339e7220dcd17d4bec712a10f010ec1a7838))
+* add agent templates ([f24fba6](https://github.com/WayfarerLabs/agentworks/commit/f24fba69e9d398d86fea6336f761676dabc469b6))
+* add apt support for getting tenv via cloudsmith ([13678d2](https://github.com/WayfarerLabs/agentworks/commit/13678d2a785d00566a428aafac06ca85abf4c42f))
+* add choose, pause, prompt_secret to output handler ([0ea9b28](https://github.com/WayfarerLabs/agentworks/commit/0ea9b28265a4eb3e7d530c5c89b5aff317dbee61))
+* add claude code plugin for nerf tools ([6b977bc](https://github.com/WayfarerLabs/agentworks/commit/6b977bceb74d17f7979d386cbc42ec6c811a10f7))
+* add claude_install flag and validate marketplace/plugin dependencies ([36dabd5](https://github.com/WayfarerLabs/agentworks/commit/36dabd5b2ea5ff6c8001181589ea61faf97c9969))
+* add config edit command ([62cb1c8](https://github.com/WayfarerLabs/agentworks/commit/62cb1c888e43c89e503297166f5d7b1b3589a951))
+* add config sync-vscode-workspaces command ([ce70a1a](https://github.com/WayfarerLabs/agentworks/commit/ce70a1a743d5a0f98bb32eef373c2821cb33770a))
+* add decoupled warning mechanism with DI and migrate all callsites ([d98184b](https://github.com/WayfarerLabs/agentworks/commit/d98184b15a12207334caffd9fa7fb6409c53e29e))
+* add hard timeout to run_detached and set 10min limit for Lima provisioning ([06e92ef](https://github.com/WayfarerLabs/agentworks/commit/06e92ef3f4420f458b3026c16f691e07478c1c9f))
+* add INFO status for non-applicable checks, stop warning on missing platforms ([e078dc5](https://github.com/WayfarerLabs/agentworks/commit/e078dc51b9daaf7362aa788e05d7fadc6c210510))
+* add liveness infrastructure -- PID checks, health checks, force kill (Phase 2) ([e341eb2](https://github.com/WayfarerLabs/agentworks/commit/e341eb213fd01c69eae537cd78d2a7da59b1ceb2))
+* add mise support ([89ad43f](https://github.com/WayfarerLabs/agentworks/commit/89ad43f9d797e176fc41174e598f7f81d749b0a0))
+* add nerf-specific env vars when nerf is installed ([78228ad](https://github.com/WayfarerLabs/agentworks/commit/78228adb8c6dbfe433b379f66b9c9dacc46ff786))
+* add output.confirm for presentation-agnostic yes/no prompts ([f4fcef9](https://github.com/WayfarerLabs/agentworks/commit/f4fcef96d9399bdf8918e8216450f33eac7683bc))
+* add output.prompt for string input collection ([a3223e4](https://github.com/WayfarerLabs/agentworks/commit/a3223e439f14b18126b346ae48804aa86df884b5))
+* add output.warn DI mechanism and migrate all warning callsites ([339ad79](https://github.com/WayfarerLabs/agentworks/commit/339ad7949b88aa621a2dc8bcc9ba25baa9944631))
+* add Proxmox VM provisioner ([4351ed1](https://github.com/WayfarerLabs/agentworks/commit/4351ed1924c5edf313be62d52c356f90eb633530))
+* add Proxmox VM provisioner ([fa0b306](https://github.com/WayfarerLabs/agentworks/commit/fa0b306b75022af3db9d21d2a516bf726a69213c))
+* add repo support for dotfiles ([d810535](https://github.com/WayfarerLabs/agentworks/commit/d81053599113dfe53159d7aedf63f282b764b0a7))
+* add run_new method with sudo and tty parameters ([6a8309f](https://github.com/WayfarerLabs/agentworks/commit/6a8309f5b0fa4ca456cb37e54ce65f251c436c33))
+* add session repair command for PID recovery (Phase 4) ([22f4404](https://github.com/WayfarerLabs/agentworks/commit/22f4404ca9743d379ef249e6a51fe7275b9b1eb7))
+* add session restart-all command ([25e954e](https://github.com/WayfarerLabs/agentworks/commit/25e954e88e838bfb8a472ba1bc9ed24b0f297fd5))
+* add ssh logging to lima provisioning ([f254894](https://github.com/WayfarerLabs/agentworks/commit/f2548943d2b9788111dbe2d0334d2822f64bbd94))
+* add stale socket cleanup on vm reinit and agent reinit ([859318b](https://github.com/WayfarerLabs/agentworks/commit/859318bc00871a4d7f931e3ffb8d042c2c34a9a8))
+* add starship user installer to catalog ([8b52275](https://github.com/WayfarerLabs/agentworks/commit/8b522755f4c0fe32cdbb37b2217d68a7d465afd1))
+* add tasks ([61a9aa0](https://github.com/WayfarerLabs/agentworks/commit/61a9aa09483fe207b0ad8887b4327d30e8e8f4a8))
+* add use-nerf-commands rule to nerf install ([1990fe8](https://github.com/WayfarerLabs/agentworks/commit/1990fe8ec0cb74aeed1102e857464936a4d93ce5))
+* add uv user installer to catalog ([0803283](https://github.com/WayfarerLabs/agentworks/commit/080328375c29119c1ddd1f6c99309d16286ad97c))
+* add vm backup command ([ad789ed](https://github.com/WayfarerLabs/agentworks/commit/ad789ed8fe5568808e297b1420a9f50c91799126))
+* add vm exec command ([8d4b816](https://github.com/WayfarerLabs/agentworks/commit/8d4b816304a6c126c1dd3dd7dcf4d1724bee9e66))
+* add vm exec command for non-interactive remote execution ([6cc26d5](https://github.com/WayfarerLabs/agentworks/commit/6cc26d51f9ea54c139569e9a3fce45549de2b313))
+* add vm port-forward to cli ([db8e571](https://github.com/WayfarerLabs/agentworks/commit/db8e57168f82467b49f3642999dbafa9fcd5399d))
+* add vm rekey command for switching Tailscale accounts ([bd8f1f1](https://github.com/WayfarerLabs/agentworks/commit/bd8f1f132cfa5b06f770c87926bcbe62e837850a))
+* add warnings fixture for tests, migrate config.py to output.warn ([1a6fe15](https://github.com/WayfarerLabs/agentworks/commit/1a6fe153c9523812a95f0aa3c41bd3ad41a03282))
+* add workspace and task describe commands ([558d1a9](https://github.com/WayfarerLabs/agentworks/commit/558d1a9459699c6371038d400c0e6ec733b77cce))
+* add workspace rehome command to move on vm filesystem ([2295873](https://github.com/WayfarerLabs/agentworks/commit/229587311726b61dc8e0640de1ca7c648bd26c2f))
+* align workspace shell/console with vm approach ([accf0f0](https://github.com/WayfarerLabs/agentworks/commit/accf0f0133cf85837f76cc7530d7cf976ba69633))
+* allow creating workspace with task ([38c908c](https://github.com/WayfarerLabs/agentworks/commit/38c908c9b08ec2d5fbb1e5ab46045a384d1da190))
+* batch stop/restart (--all, --all-stopped) with --vm/--workspace filters ([324d7ba](https://github.com/WayfarerLabs/agentworks/commit/324d7ba3058a981210f7949a14b431e2aa9f6237))
+* Claude Code marketplace and plugin support in templates ([d82573a](https://github.com/WayfarerLabs/agentworks/commit/d82573ad53d4b5e7e5b81b2d4cdd6b9784a9d79e))
+* clean up vm handling of agents and tasks ([fec6506](https://github.com/WayfarerLabs/agentworks/commit/fec65062bb97725d02bd1cf6d61bbca748a0295e))
+* **cli:** add comment above Include directive in SSH config ([5441d33](https://github.com/WayfarerLabs/agentworks/commit/5441d337bd75732ba5ee5e5ba4b83a8fc66b2a5f))
+* **cli:** add config sync-ssh-config command to rebuild SSH config on demand ([dd9b615](https://github.com/WayfarerLabs/agentworks/commit/dd9b615bd3f8158774d85165b162433c5ff8ab26))
+* **cli:** add test field to install commands for skip-if-installed ([0255c45](https://github.com/WayfarerLabs/agentworks/commit/0255c458e4731735da38a9d92e6186bee3c3680b))
+* **cli:** add test field to install commands for skip-if-installed checks ([47dab73](https://github.com/WayfarerLabs/agentworks/commit/47dab73546d6e1edfde0c4cc53e299eb05437059))
+* **cli:** integrate nerf tools into VM init via config ([dfb26fd](https://github.com/WayfarerLabs/agentworks/commit/dfb26fdb563dac4920dada2b1d5298f1931483d3))
+* **cli:** manage SSH config via config.d with configurable host prefix ([14a2880](https://github.com/WayfarerLabs/agentworks/commit/14a28800609c10473daea86122f27f5ec1098bcd))
+* **cli:** move init to config init, add config sample ([88b9484](https://github.com/WayfarerLabs/agentworks/commit/88b94843d64c4b2345c3e85ec615f13de762ef9e))
+* **cli:** move init to config init, add config sample ([96fad41](https://github.com/WayfarerLabs/agentworks/commit/96fad4187cb065d8c814dec5e5efed0b6ad766d4))
+* **cli:** replace test with test_exec/test_file/test_dir, add fnm and unzip ([6f38492](https://github.com/WayfarerLabs/agentworks/commit/6f3849262bbd8890898079d691fd7c56b4fc613f))
+* **cli:** replace test with test_exec/test_file/test_dir, add fnm and unzip ([968e471](https://github.com/WayfarerLabs/agentworks/commit/968e471134c6031d063c8b440990891c61ceeecb))
+* **cli:** resilient provisioning with nohup detached execution ([6fe4cef](https://github.com/WayfarerLabs/agentworks/commit/6fe4cef516d93e6bb93bcf37b2382a82ca5c4b84))
+* **cli:** resilient provisioning with nohup detached execution ([d9f06b3](https://github.com/WayfarerLabs/agentworks/commit/d9f06b353e542453bbd586e3c9993c15081b16e5))
+* complete agents ([42f4e12](https://github.com/WayfarerLabs/agentworks/commit/42f4e12703bbf046166e371df7d874fb01f3bca3))
+* default workspaces to /opt/agentworks with config option ([3bbc042](https://github.com/WayfarerLabs/agentworks/commit/3bbc042f67dfe980741b45ffb4acaa006d504098))
+* detach Azure public IP after provisioning and poll for Tailscale stability ([0761ad9](https://github.com/WayfarerLabs/agentworks/commit/0761ad90b37a0e82c37c49c367a8cd544d14a17a))
+* ditch rules as plugins don't support them ([03937e4](https://github.com/WayfarerLabs/agentworks/commit/03937e40401f187b8e4fad69cac9c7577151568f))
+* drop cached status column, add PID column and SessionHealth enum (Phase 1) ([4687276](https://github.com/WayfarerLabs/agentworks/commit/4687276679ecd62f3a48a547f688925b00583ba1))
+* enhancements to nerfctl grant capabilities including skill mapping for easy ux ([a2f23f6](https://github.com/WayfarerLabs/agentworks/commit/a2f23f6c2ef0e5f2b81017f96a8b696e23e0ca71))
+* ensure logging across all operations ([90cd0c8](https://github.com/WayfarerLabs/agentworks/commit/90cd0c87bd0019b5f092dde6d3a4da528900f4f3))
+* force explicit admin vs agent selection for new tasks ([6f899e9](https://github.com/WayfarerLabs/agentworks/commit/6f899e923f340974c0fd87622f1c9ef07fc67852))
+* implement optional mise pruning and clarify idempotency ([f0162f7](https://github.com/WayfarerLabs/agentworks/commit/f0162f76c28b8c6306d22f21c6f92c6bc8447d8f))
+* implement vm templates (lock og sdd) ([9e4ac61](https://github.com/WayfarerLabs/agentworks/commit/9e4ac6172b48e080bf74360fa395c35b303f04d5))
+* improve vm backup with single zstd archive and reliable detached execution ([7b9d72a](https://github.com/WayfarerLabs/agentworks/commit/7b9d72a743a818b6ec6e685d10870b66d79d7ccd))
+* improve vm backup with single zstd archive, progress reporting, and reliable detached execution ([21d6849](https://github.com/WayfarerLabs/agentworks/commit/21d6849a7a87f8cf72ab33be1d21083041549a36))
+* improve vm describe with live resources ([9643e48](https://github.com/WayfarerLabs/agentworks/commit/9643e4827429f95d310ed5db1b5a4b198e4f3425))
+* install nerfctl tools along with nerf commands ([1e6022c](https://github.com/WayfarerLabs/agentworks/commit/1e6022c7bcd13f4177cd82c9bf3c42af770f1230))
+* integrate agent socket setup into VM init and agent provisioning ([dbc9399](https://github.com/WayfarerLabs/agentworks/commit/dbc939909cd11a8f191093d0de6420ff4fa7d2e5))
+* migrate all session commands to health-based liveness model (Phase 3) ([bd56d71](https://github.com/WayfarerLabs/agentworks/commit/bd56d71fa088c43338fdd2faff7525e78ada4967))
+* offer to delete auto-created workspace upon only task deletion ([ffb52c7](https://github.com/WayfarerLabs/agentworks/commit/ffb52c7fd03fabd49ee976bd2ac9b21f99283882))
+* Phase 6 -- unified status model (has-session primary, boot_id, session type dispatch) ([4d7024f](https://github.com/WayfarerLabs/agentworks/commit/4d7024f89143f1502cf2368a5da69f5218ac385b))
+* protect vm deletions based on tasks ([8f91cdc](https://github.com/WayfarerLabs/agentworks/commit/8f91cdce87925e2a299a03c684d6c91f59e219c0))
+* robust ssh logging ([f9b715b](https://github.com/WayfarerLabs/agentworks/commit/f9b715bc915738f895bfe221c3bb2cb3464eb740))
+* run agent tmux sessions as the agent user via per-task sockets ([9cc13f7](https://github.com/WayfarerLabs/agentworks/commit/9cc13f7ead4afab90b88a63e0bb3026ae93946dc))
+* run dist-upgrade during bootstrap to keep base image current ([81d134b](https://github.com/WayfarerLabs/agentworks/commit/81d134b14ff9b8fdf363c4aac1853525e4ebaccc))
+* set consistent VM hostname as <platform>--<vm_name> ([0473f13](https://github.com/WayfarerLabs/agentworks/commit/0473f1380e37c247e91875dee698ca056de641ef))
+* show tasks and agents in vm describe ([97f53b4](https://github.com/WayfarerLabs/agentworks/commit/97f53b4965bbba2aefc149a0ce180b707198f1a0))
+* support claude code marketplaces and plugins in admin and agent templates ([47f1c93](https://github.com/WayfarerLabs/agentworks/commit/47f1c938fc98e2d0cddbe126b43496d70b854dcf))
+* task enhancements and fixes ([6761f82](https://github.com/WayfarerLabs/agentworks/commit/6761f82711d4321adff58565284a087693916c8f))
+* task restart impl ([079aacf](https://github.com/WayfarerLabs/agentworks/commit/079aacf7b90722ad23ec2371104d1e3e41664c80))
+* thread socket paths through task manager, console, and tmuxinator ([160e70d](https://github.com/WayfarerLabs/agentworks/commit/160e70de68a5c9e59077aa93a00499f82d2c981f))
+* unified output module with handler protocol and exception hierarchy ([0c8bd05](https://github.com/WayfarerLabs/agentworks/commit/0c8bd054b4b904cb350132b9a62c05c95c3430ba))
+* update nerf skills to reference nerf env vars ([7ce3996](https://github.com/WayfarerLabs/agentworks/commit/7ce3996e51c96f3d9742c1002c35fdf7f746257a))
+* upgrade to nerftools 1.0.0 and use default plugin metadata ([4be19d2](https://github.com/WayfarerLabs/agentworks/commit/4be19d22deda4605c938de4eedf394d866ffdc3d))
+* use consistent table formatting for workspaces vs tasks ([96530ed](https://github.com/WayfarerLabs/agentworks/commit/96530edaf25ddef6f13a4e89c7609242a2545ce0))
+* use native provisioning and add swap support ([c393bd9](https://github.com/WayfarerLabs/agentworks/commit/c393bd9f7ecdbf842ee8569e92a0e42f1b04e211))
+* verbose force-kill output (SIGTERM, escalation, socket cleanup) ([ec86990](https://github.com/WayfarerLabs/agentworks/commit/ec86990c5f9a081cbedbdf754cf3ab9a6d05ce53))
+* verbose stop output (C-c, grace period, survivors, force-kill escalation) ([48a5ff1](https://github.com/WayfarerLabs/agentworks/commit/48a5ff14c022b8e9209b21966c936cd132e6b1c0))
+* vm rekey prints env key detection, add --ignore-env flag ([675c41b](https://github.com/WayfarerLabs/agentworks/commit/675c41b669de7bfbbb8b5528180763344b43fbb0))
+* warn about broken/unknown sessions at bottom of session list ([b82e9d0](https://github.com/WayfarerLabs/agentworks/commit/b82e9d0b3c1cf462f6af96b6a671dcb10a235ce2))
+* warn when agent task is found on legacy default server ([4d68b2c](https://github.com/WayfarerLabs/agentworks/commit/4d68b2c6482ab45417d4fcbe59da190b8d3fa8db))
+* workspace copy ([dde6c28](https://github.com/WayfarerLabs/agentworks/commit/dde6c28596e7b0145e81795d70bd622d374c5d10))
+* workspace repair command ([52ab828](https://github.com/WayfarerLabs/agentworks/commit/52ab828a8de57f5bf4037257b2da1ccc89dd12a3))
+
+
+### Bug Fixes
+
+* add 10-minute timeout to dist-upgrade during bootstrap ([7513a62](https://github.com/WayfarerLabs/agentworks/commit/7513a621f080a2203b9da2fbe9f6303f9125e071))
+* add get_warn_handler and restore previous handler in test fixture ([c605c29](https://github.com/WayfarerLabs/agentworks/commit/c605c29a4ceee349af902d2870b448826a8e01c9))
+* add indent param to detail, Ctrl-C handling in confirm/prompt_secret ([260a7a3](https://github.com/WayfarerLabs/agentworks/commit/260a7a3b35fce52cf43974d2057ff8cbc3a77e62))
+* add logger redaction and IP validation in _join_tailscale ([8dd5223](https://github.com/WayfarerLabs/agentworks/commit/8dd52235b6fa5c83903aad9b107d08e8d1c03507))
+* add migration guard for legacy agent sessions without socket_path ([933c35c](https://github.com/WayfarerLabs/agentworks/commit/933c35c642658dd38f875433773f77e900f1b203))
+* add SSH non-interactive options to vm exec ([33e8417](https://github.com/WayfarerLabs/agentworks/commit/33e84172b404fa0105aed995004d84610e026f7e))
+* add success message for agent git safe.directory setup ([bf3649a](https://github.com/WayfarerLabs/agentworks/commit/bf3649aa0896edb35a15254f5ade60eac9b1b320))
+* address 5 PR review items -- error context, EOF handling, progress API ([0065881](https://github.com/WayfarerLabs/agentworks/commit/0065881ddf67ef067cb91259041ea867594596a2))
+* address Copilot PR review feedback ([f8442eb](https://github.com/WayfarerLabs/agentworks/commit/f8442ebe59bd4f1238753e7f2dab40ead73b1a7b))
+* address Copilot review -- PID parsing, force_kill return, CLI validation, test patterns, rehome ([bee6665](https://github.com/WayfarerLabs/agentworks/commit/bee66657c5253be8bb5749f976141dca6f24ef0c))
+* address PR feedback on Proxmox provisioner ([c4955fd](https://github.com/WayfarerLabs/agentworks/commit/c4955fddc07493fef3b29811b45046ee68482e92))
+* address PR review - use custom for catalog sources, fix proxmox hasattr, align terminology ([8b208f4](https://github.com/WayfarerLabs/agentworks/commit/8b208f44864425ea6ef8f626ded486c38c2dd812))
+* address PR review -- nohup ordering, auth key quoting, IP validation ([95c264d](https://github.com/WayfarerLabs/agentworks/commit/95c264dd7f76d4c1f2150a33a808c9f0d601e3e0))
+* address PR review -- remove backward compat, guard division, raise on failure ([6a60510](https://github.com/WayfarerLabs/agentworks/commit/6a605107c5b0cd30d239745751ffbb96cc4170ff))
+* address PR review -- robust find -exec, merge split imports ([02fd2ab](https://github.com/WayfarerLabs/agentworks/commit/02fd2abc4b21ad24a9c6ec09089da5c1c4500a89))
+* address PR review -- safer return type, broader cspell glob ([8f86d56](https://github.com/WayfarerLabs/agentworks/commit/8f86d56db3db5e685fbf0a9ad093c532d6b30182))
+* address PR review -- ValidationError, error context in exceptions, UserAbort on Ctrl-C ([c492952](https://github.com/WayfarerLabs/agentworks/commit/c49295271439d9947cf6eaf162518dbc0c47208d))
+* address PR review -- WSL2 support, quiet flag, resilient output read, test ([5eb2b27](https://github.com/WayfarerLabs/agentworks/commit/5eb2b27cb4deaef5a756a164a13f72e4558c9ade))
+* address PR review comments - catalog terminology, UserConfig alias, [user] section backward compat ([bca0451](https://github.com/WayfarerLabs/agentworks/commit/bca04519d401444ef2f783a57e9ac28665c3d0ce))
+* address PR review feedback from Copilot ([89b0db6](https://github.com/WayfarerLabs/agentworks/commit/89b0db67e2ec5f5c8c65a3f46e3b151ed02cc42c))
+* admin-mode health (session-ended vs BROKEN), sudo on tmux cmds, delete UNKNOWN handler, test annotations ([5567a2e](https://github.com/WayfarerLabs/agentworks/commit/5567a2ea8cf4b347e3e28e09fccf8305959fc8a5))
+* allow empty message ([9387992](https://github.com/WayfarerLabs/agentworks/commit/9387992977981b335d8766c7b6866295c62128d2))
+* allow for retries on tailscale echo test ([0ae2505](https://github.com/WayfarerLabs/agentworks/commit/0ae25052ff24b094f7982c99594b79a6f7ba89d9))
+* allow inheriting from undefined default templates ([1fcb257](https://github.com/WayfarerLabs/agentworks/commit/1fcb257675468dfb6050198ba5acdb520a34fdcb))
+* always verify SSH connectivity after rekey, not just with --wait-for-share ([48fb445](https://github.com/WayfarerLabs/agentworks/commit/48fb4456e82671bcc4b19fd46c97b51893a37cbd))
+* attach logger to ExecTarget in _create_agent_on_vm, add migration tests ([d77dcb3](https://github.com/WayfarerLabs/agentworks/commit/d77dcb30b999ef43e888967bf3e96ffb7d652177))
+* avoid redundant stdout.strip() calls in IP validation ([6d1cabf](https://github.com/WayfarerLabs/agentworks/commit/6d1cabfd711dd2fc9d535727efe9079f0b142c3b))
+* avoid zsh brace parsing issue in ensure_agent_socket_root ([4f94915](https://github.com/WayfarerLabs/agentworks/commit/4f949154051dd4ace438f494c88c378d51d2f2d2))
+* Azure admin_exec_target used stale config.user instead of config.operator ([89ae6ef](https://github.com/WayfarerLabs/agentworks/commit/89ae6ef495e61c67af8baa0355dd65fdb595e622))
+* backfill socket_path on restart for migrated sessions ([de0ce3e](https://github.com/WayfarerLabs/agentworks/commit/de0ce3e08904ff07c209a920f1187aa5d70d5386))
+* **backup:** address PR review - mktemp staging, kill on interrupt, proxy_jump, archived_paths in manifest, test coverage ([97e11a1](https://github.com/WayfarerLabs/agentworks/commit/97e11a1681e64c3e94ee06809eb009315a14f9ff))
+* **backup:** create detached dir as admin so run_detached can scp wrapper script ([e08338d](https://github.com/WayfarerLabs/agentworks/commit/e08338d06d36a07828ca330df1651da676dbb1ca))
+* **backup:** secure mktemp -d for run_detached base, rename scp_base_args public, assert success in force_tty test ([3f81ad2](https://github.com/WayfarerLabs/agentworks/commit/3f81ad2d8fbd474627d9fd5051c011c18dd52fc4))
+* batch quoting, ensure_pid consistency, rehome strictness, admin PID safety, status-aware delete ([54f2761](https://github.com/WayfarerLabs/agentworks/commit/54f276184d1a2f4fb4a0b280246ed3fb404c24c9))
+* batch status checks per VM (not per workspace) with parallel execution ([62a60f9](https://github.com/WayfarerLabs/agentworks/commit/62a60f9f5d83d6fe134174e325e74c65ec35f1d0))
+* batch stop/restart error on unknown sessions after auto-repair ([34a37eb](https://github.com/WayfarerLabs/agentworks/commit/34a37eb3ea63e14950386e92aa424e9c63287300))
+* be sure to logs timeouts ([fbc117a](https://github.com/WayfarerLabs/agentworks/commit/fbc117a656c1f3e5963fbc5674b7de9fc72dc4ab))
+* best-effort PID capture (check=False), document PID reuse non-goal with math ([97d884c](https://github.com/WayfarerLabs/agentworks/commit/97d884c065b5ca2862bf3607c04f91d35ec51fde))
+* boot_id truthiness -> is not None, cache _get_boot_id per target ([37d547b](https://github.com/WayfarerLabs/agentworks/commit/37d547bea339c4026e3f146629611f25f981d6fa))
+* broken session warning wording ([2ee5af0](https://github.com/WayfarerLabs/agentworks/commit/2ee5af02bf5f931c42cadf10e5c0e5feebfc9137))
+* BrokenSessionError replaces string matching, require boot_id with positive PID ([604e4cc](https://github.com/WayfarerLabs/agentworks/commit/604e4ccc1d27b1bc83a22c3ca0335a6d96961478))
+* catch ConfigError at top level for clean error output ([fbc60e6](https://github.com/WayfarerLabs/agentworks/commit/fbc60e6a84f1bba94fa83034ab40a08be89a5af3))
+* check both socket and default server for legacy session migration ([b92ca8b](https://github.com/WayfarerLabs/agentworks/commit/b92ca8b6ee0019cffb838b904ec6b922e2c1e0fb))
+* check for existing socket on session create and clean up or fail ([37af519](https://github.com/WayfarerLabs/agentworks/commit/37af5192e6963aeeee7a19fd40518e854345611c))
+* check force_kill return in delete paths, fix UNKNOWN messages and list display, update docstring ([ee1c74d](https://github.com/WayfarerLabs/agentworks/commit/ee1c74daa3d5545c1eaadd96cfa3e1edc43150c0))
+* check kill_session return in restart path ([e557adb](https://github.com/WayfarerLabs/agentworks/commit/e557adb1ca65fcd66abb87a897a94e920c8a4697))
+* clean up agent socket after successful stop ([43fba5e](https://github.com/WayfarerLabs/agentworks/commit/43fba5ec38a0bae1258b9afeb7df7d5d14e8c515))
+* clean up azure start/stop logic ([6b10ffb](https://github.com/WayfarerLabs/agentworks/commit/6b10ffb1182ff712bb792214ff41d8f2166db671))
+* clean up failed init prompt ([7457d94](https://github.com/WayfarerLabs/agentworks/commit/7457d94cbb318948e6d6dc6bc37161fa44671336))
+* clean up waiting for tailscale reconnect on azure public ip operations ([d7afe62](https://github.com/WayfarerLabs/agentworks/commit/d7afe6202a5ba99d9c5c91939f40be96ca2b7af3))
+* **cli:** address PR feedback for resilient provisioning ([17c9ed5](https://github.com/WayfarerLabs/agentworks/commit/17c9ed531b5c461e88816b9d1be2a80e4e6581d8))
+* **cli:** address PR review comments on test_exec/test_file/test_dir ([19bf95a](https://github.com/WayfarerLabs/agentworks/commit/19bf95acaaadbe0070cab35cc9678e353927ba59))
+* **cli:** address PR review feedback for SSH config ([35917af](https://github.com/WayfarerLabs/agentworks/commit/35917aff00330cc721226c4ac98c5fa3cac3b170))
+* **cli:** address second round of PR feedback ([bdbcde6](https://github.com/WayfarerLabs/agentworks/commit/bdbcde696670e32e8ffaeb82aa0e7372d81e6faa))
+* **cli:** call nerftools Python API directly instead of subprocess ([281dc1a](https://github.com/WayfarerLabs/agentworks/commit/281dc1a0fdc868912ee6c8527bc6c8093fb0bed8))
+* **cli:** check for limactl before local provisioning, suggest --vm-host ([4112cd7](https://github.com/WayfarerLabs/agentworks/commit/4112cd74f7b6d7118fc2fc11bb0996df24d7b0ea))
+* **cli:** clean up provisioning console output, suppress verbose lima logs ([2b32db2](https://github.com/WayfarerLabs/agentworks/commit/2b32db2704d8aebbc0ea09ad59cd62d884e8e8a8))
+* **cli:** co-locate config commands, fix trailing newline in sample output ([b6a4472](https://github.com/WayfarerLabs/agentworks/commit/b6a4472163795f376a648c0a434365bbfd557cae))
+* **cli:** expand tilde to $HOME in test paths so shell expansion works ([49c42e8](https://github.com/WayfarerLabs/agentworks/commit/49c42e86a43225ad0e328c0d692e1e6d03479104))
+* **cli:** fix nerf dir permissions and double-sudo on VM deploy ([70f586c](https://github.com/WayfarerLabs/agentworks/commit/70f586c3878b73bfc774e05b6bdfbbcf0b144017))
+* **cli:** fix sudo escalation in nerf tools deploy ([f20249f](https://github.com/WayfarerLabs/agentworks/commit/f20249ffd91d43545d4452c36b65dc5a914c4432))
+* **cli:** log full traceback on vm create errors for debugging ([96b0b91](https://github.com/WayfarerLabs/agentworks/commit/96b0b91aec98aa2b4b0126bade0259583a81eed9))
+* **cli:** rebuild SSH config after DB delete so deleted VM is excluded ([2549c28](https://github.com/WayfarerLabs/agentworks/commit/2549c284c3f4a222e0cde6bbf926d9f28c65215a))
+* **cli:** remove rsync dependency -- use copy_dir_to (tar+scp) for all dir transfers ([5624b6d](https://github.com/WayfarerLabs/agentworks/commit/5624b6d7cfaaa9e6cfc3ef622887252a39f61e40))
+* **cli:** run test_exec checks in login shell so PATH additions are visible ([91be879](https://github.com/WayfarerLabs/agentworks/commit/91be87973714cb50220212f681a078fec6d2501c))
+* **cli:** separate error handling for provisioning, init, and post-init ([7fc269b](https://github.com/WayfarerLabs/agentworks/commit/7fc269b1cd68de18b07db63103db334c061afcc2))
+* **cli:** set +x on nerf scripts and add zsh PATH support ([2965636](https://github.com/WayfarerLabs/agentworks/commit/29656369fda7162cea58f0c8c29f73e0ee5aa721))
+* **cli:** use Command result type for PS subcommand completions to suppress file fallback ([a55a463](https://github.com/WayfarerLabs/agentworks/commit/a55a463908a113866f316b132d49acdb64421e8d))
+* **cli:** use forward slashes in SSH config paths for Windows compatibility ([019c8ed](https://github.com/WayfarerLabs/agentworks/commit/019c8ed0e0d1ac9d11cb6fc7a8eb03ab3a735ee1))
+* **cli:** use interactive login shell for test_exec checks (-lic not -lc) ([a0136f1](https://github.com/WayfarerLabs/agentworks/commit/a0136f1ffeb60df9d511d6b881979ebb6b81f359))
+* **cli:** use short timeout for install test checks, handle timeout gracefully ([ab04120](https://github.com/WayfarerLabs/agentworks/commit/ab04120bc0f34f12e69564f2976212ad3da5da84))
+* **cli:** use tilde for home directory in SSH config paths ([b1f0696](https://github.com/WayfarerLabs/agentworks/commit/b1f06962b3ef9d62d8035681665a870964a60c0f))
+* **cli:** warn on unexpected keys in vm.config and agent.config sections ([359874e](https://github.com/WayfarerLabs/agentworks/commit/359874ea74c1f9e9fd0e35b722cd97370a9aa715))
+* compute socket_path before INSERT, add constraint tests ([9c22b40](https://github.com/WayfarerLabs/agentworks/commit/9c22b4090c52f46604207bdf4b7378c70b671cae))
+* confirm before force-kill in delete, _get_boot_id returns None on failure, get_tmux_server_pid validates > 0 ([edc466c](https://github.com/WayfarerLabs/agentworks/commit/edc466ce4f40700f369029ea0d12cd9c61b772f0))
+* consistent singular labels in doctor summary ([f6d8df8](https://github.com/WayfarerLabs/agentworks/commit/f6d8df847d08d1ed93e5d53c957f46cb35cf76e0))
+* Copilot round 2 -- auto-repair in batch paths, SSH logger, honest UNKNOWN on ambiguous recovery ([d121b06](https://github.com/WayfarerLabs/agentworks/commit/d121b0652f679aba6bcd3cf49bf0233392581bcb))
+* correct E501 line-length on session restart-all workspace option ([8e7ab7c](https://github.com/WayfarerLabs/agentworks/commit/8e7ab7cd475e17daff19174418aa300b4f192797))
+* correct missing force_tty logic ([b8b18b6](https://github.com/WayfarerLabs/agentworks/commit/b8b18b6a10db5d3b1f0889293ba75da36fea3bfc))
+* decouple _check_completions from CLI import, mark smoke test as integration ([06b43fe](https://github.com/WayfarerLabs/agentworks/commit/06b43fe6a69b15f5ebee910b91732621c35616ac))
+* delete uses prompts for running/unknown, --force only for BROKEN ([2eb9acb](https://github.com/WayfarerLabs/agentworks/commit/2eb9acb606963cea0214d81caeb74c193a06203d))
+* derive socket path for migrated agent sessions with NULL socket_path ([0a1405e](https://github.com/WayfarerLabs/agentworks/commit/0a1405ee00d01eb19cfba37f02f8c72c2d77510c))
+* detect SSH transport failure (returncode 255) in has-session checks ([025a057](https://github.com/WayfarerLabs/agentworks/commit/025a05781097fb1226387985b71b3861bed3a9dd))
+* disable git safe directory failures by default ([aeaf101](https://github.com/WayfarerLabs/agentworks/commit/aeaf1015a35284101d376cc22f7ce617daae2f2a))
+* distinguish unknown (NULL) from known-stopped (PID=-1) sessions ([13ebb20](https://github.com/WayfarerLabs/agentworks/commit/13ebb20433f15dcfbc783f664ea97eedfbb635e7))
+* docstring inaccuracy ([6c89ef7](https://github.com/WayfarerLabs/agentworks/commit/6c89ef7efa8ae0b7481627bbb192461e559fa0c2))
+* **doctor:** don't warn on false file perms for ssh key on windows ([8da3431](https://github.com/WayfarerLabs/agentworks/commit/8da3431aa3d438fe39864b9a9b69b8f6f01284e4))
+* don't output log for successful reinit ([cf7d7df](https://github.com/WayfarerLabs/agentworks/commit/cf7d7dfa21d2d5777d214c39c4f36fc0b7aead2c))
+* don't warn on missing socket dir on vm create (only reinit) ([dc3f529](https://github.com/WayfarerLabs/agentworks/commit/dc3f52935a3d4b8b360073b7e8daca839788a055))
+* dont force tty for detached ops ([fd3f757](https://github.com/WayfarerLabs/agentworks/commit/fd3f7574862438f8a2aae810509ab437bc895dc7))
+* ensure acl package is installed and delete workspaces as root ([8590dc7](https://github.com/WayfarerLabs/agentworks/commit/8590dc79a1e384d183508262e6dc6603670e3b1d))
+* ensure existing apt sources are correct ([e10d4eb](https://github.com/WayfarerLabs/agentworks/commit/e10d4ebb999921171c934193b69c5d2d1ff9739d))
+* ensure we are redacting secrets in vm reinit logs ([bd6688f](https://github.com/WayfarerLabs/agentworks/commit/bd6688f3b03c45301ae2a23dba1ca6a8e04364cd))
+* ensure_pids_batch catches SSH errors per-VM, rehome wraps status check errors ([ac96ee1](https://github.com/WayfarerLabs/agentworks/commit/ac96ee130be3410682c661796078b74332fb17a3))
+* explicitly remove tmux socket file on session delete ([bae1e88](https://github.com/WayfarerLabs/agentworks/commit/bae1e88031b5ad51bf5ae24f191642f47a4e1eb8))
+* fix agent shell with workspace arg ([f27ea22](https://github.com/WayfarerLabs/agentworks/commit/f27ea22c810e6608f8f3b74a2154d3090078efca))
+* fix comment on socket test ([86a5cc6](https://github.com/WayfarerLabs/agentworks/commit/86a5cc668cdb58b47330f71235ebbc827737996e))
+* fix doctor for agent git creds ([e327c82](https://github.com/WayfarerLabs/agentworks/commit/e327c82525b1f4e3f066c2caf23170a66ffe12ca))
+* fix inheritence to match adr ([5b46ba9](https://github.com/WayfarerLabs/agentworks/commit/5b46ba985a6fa1300ca04bb6d5732d15b4342fcb))
+* fix nerf home and claude plugin permissions ([b30d20f](https://github.com/WayfarerLabs/agentworks/commit/b30d20f7ff02136ef9d50fef4387b6b87d948fd7))
+* fix other windows character encoding issues ([1209f2e](https://github.com/WayfarerLabs/agentworks/commit/1209f2ed1dbf9c36b466244149610dbe33a8b62a))
+* fix two rename bugs and deduplicate describe_session status reconciliation ([e9c5b55](https://github.com/WayfarerLabs/agentworks/commit/e9c5b55234185608c61ab3cc52c6963d3c592ffd))
+* fix windows-specific test issues ([7bc8a9f](https://github.com/WayfarerLabs/agentworks/commit/7bc8a9f9260c6cba22f1eed04d7bc333941d0520))
+* fix workspace copy and deletion ([736caab](https://github.com/WayfarerLabs/agentworks/commit/736caab534b97afdc68975fd022162a1120ac870))
+* fix workspace rehome and create filesystem permissions ([628f355](https://github.com/WayfarerLabs/agentworks/commit/628f355a12b3c2e7a5cd58ffa894c812b97d7dce))
+* fold tar failure context into BackupError instead of stdout detail ([3df0a9e](https://github.com/WayfarerLabs/agentworks/commit/3df0a9e29fc7e6b44632471c988f2176ecdd45c1))
+* force an interactive shell for tasks ([d68dcd0](https://github.com/WayfarerLabs/agentworks/commit/d68dcd09e9c88ef9d616ff277d7f16a328d34c16))
+* force task session to resize based on latest attached client ([71207ce](https://github.com/WayfarerLabs/agentworks/commit/71207ce183f9917d7976e44a74145339fb1e4068))
+* force tty for windows ([e20d88b](https://github.com/WayfarerLabs/agentworks/commit/e20d88bdf747ef0ead04652d6d290fba94ef8bae))
+* force utf8 encodings to avoid windows charset issues ([4917860](https://github.com/WayfarerLabs/agentworks/commit/491786020936f083c63fc80413aa7439e3d19437))
+* fully decouple doctor from CLI, consolidate config error, CI-level test filtering ([feca4c5](https://github.com/WayfarerLabs/agentworks/commit/feca4c536d96838c406de96a87d5f993c504b6d5))
+* guard all update_session_pid calls against None boot_id, remove stale comment ([177eebb](https://github.com/WayfarerLabs/agentworks/commit/177eebb56c30acdbf113d58ed5d402a8631477dd))
+* handle EOF/Ctrl-C in default handler, ValidationError for choose, consistent output usage ([0b80513](https://github.com/WayfarerLabs/agentworks/commit/0b805137e2d5b5bc091d1985889f46134d98eedc))
+* handle existing dotfiles clone on agent reinit ([0df9570](https://github.com/WayfarerLabs/agentworks/commit/0df9570d595dc584e13f9dc09a3e65cbae977870))
+* hide stale PID in session describe (only show if current boot) ([004b9e1](https://github.com/WayfarerLabs/agentworks/commit/004b9e181b507f6a63a417c38a0272f26cfea40f))
+* idempotently ensure that socket directories are in place for session ops ([5012a86](https://github.com/WayfarerLabs/agentworks/commit/5012a86d6d1dc3f86aee507edb463031c2efa0a4))
+* include error in claude check warning, add sample config notes, add tests ([afd03a7](https://github.com/WayfarerLabs/agentworks/commit/afd03a7358b6bb7474aecaf3556cbaaec61db575))
+* include exception in completions warning, align labels, exclude integration tests ([c20ecfa](https://github.com/WayfarerLabs/agentworks/commit/c20ecfaf86aa7fd707e5a9fc4de9ba26c2164a46))
+* include info count in doctor summary ([742b8d8](https://github.com/WayfarerLabs/agentworks/commit/742b8d84903c9c12093ff88489e461ec08c56fd3))
+* incorporate pr feedback ([0cc7026](https://github.com/WayfarerLabs/agentworks/commit/0cc702669e55fac48b786c9610c83a05cbe236e9))
+* increase timeout and add retries for resource fetch ([b7e82d7](https://github.com/WayfarerLabs/agentworks/commit/b7e82d7d723d4322e44fe0a267f6caadb6686b33))
+* kill agent socket sessions during workspace delete ([a17955b](https://github.com/WayfarerLabs/agentworks/commit/a17955bcc681a4f794e3e7d40719f08913c3a564))
+* lingering unit test and lint errors ([3d4a90f](https://github.com/WayfarerLabs/agentworks/commit/3d4a90f3e78b59f75dcbcae71464786a3e32fdf4))
+* load creds (inc. prompting) before creating agent, same as vm ([2ce2d63](https://github.com/WayfarerLabs/agentworks/commit/2ce2d63c6a9ce353eed1dc7c88f1728830fbd2cb))
+* make all create commands consistent w.r.t. prompting for targets and non-interactive behavior ([7dfe803](https://github.com/WayfarerLabs/agentworks/commit/7dfe803c162bb070f6224732476a3e8b2af8f129))
+* make run_detached fully SSH-resilient end-to-end ([ae9df9a](https://github.com/WayfarerLabs/agentworks/commit/ae9df9af6f939ae90fbf7c5c73264e801b0c460b))
+* move ipaddress import to function/file top-level per convention ([5a2e5b3](https://github.com/WayfarerLabs/agentworks/commit/5a2e5b3adee54262f2559e30b025140c850e7c90))
+* null boot_id triggers UNKNOWN and auto-repair (both pid + boot_id required) ([4691ef0](https://github.com/WayfarerLabs/agentworks/commit/4691ef0ac7a79f65edfdfdb41161654b8b934c37))
+* only remove socket file after confirming tmux server has exited ([f154a72](https://github.com/WayfarerLabs/agentworks/commit/f154a72b766bd92fc9db91a60be5fcdcc6feb0fa))
+* only remove socket when post-delete status is definitively STOPPED ([0e0aa9d](https://github.com/WayfarerLabs/agentworks/commit/0e0aa9d977c316f2cb07261fcd37a4fba54100c0))
+* pass args directly to ssh instead of shlex.join ([07736cc](https://github.com/WayfarerLabs/agentworks/commit/07736ccb8b2d609aa8c21ed9364f2ae74e7b9fc3))
+* PID validation, boot_id cache failures, kill_session return checks, stale terminology ([a58fe2c](https://github.com/WayfarerLabs/agentworks/commit/a58fe2c5a0c9a35aa72fe973e3cbf8f160d06974))
+* PID_STOPPED excluded from unknown detection in batch stop/restart ([f11a99e](https://github.com/WayfarerLabs/agentworks/commit/f11a99e9de7a98c6e352344d5d614d99cbe93a67))
+* PID_STOPPED is definitively stopped -- skip repair, show stopped not unknown ([ebd6403](https://github.com/WayfarerLabs/agentworks/commit/ebd64037f3df078ee9d6e9c92d10cdf42c4a643d))
+* preserve arg quoting via shlex.join, pass single-string commands as-is ([9871835](https://github.com/WayfarerLabs/agentworks/commit/98718358a1a96e53fe92d8e9dfba1a85cd1d68c8))
+* prevent cloud-init for regenerating ssh keys on vm stop/start ([7ce36de](https://github.com/WayfarerLabs/agentworks/commit/7ce36de3e878153ffca1fa21124571b12ecc8e90))
+* properly handle multiple git creds per provider ([241c4cb](https://github.com/WayfarerLabs/agentworks/commit/241c4cb63bab0be7c4564d89173eadf97f8e9689))
+* properly report config issues in doctor ([e8e9261](https://github.com/WayfarerLabs/agentworks/commit/e8e926126b78591529540d57b334167c2da52ef3))
+* protect agent deletion and clean up task/agent tables ([e34ef6a](https://github.com/WayfarerLabs/agentworks/commit/e34ef6a3321dd7171ba71f453b801a23ea2268a6))
+* raise ProxmoxAPIError on unexpected network-get-interfaces shape ([5e1983a](https://github.com/WayfarerLabs/agentworks/commit/5e1983acea205b8a32c3e8335666a5cf2b0c0d0f))
+* recheck status after failed kill (race condition), check kill return in delete_session ([df9c3f4](https://github.com/WayfarerLabs/agentworks/commit/df9c3f40a9ad106c99144eed1fae0634e430c0f6))
+* reconcile stopped tasks back to running when session is alive ([4f0428c](https://github.com/WayfarerLabs/agentworks/commit/4f0428c9591ea4a46973b8d17441f5b3b25fe938))
+* record vm template in db and show in command output ([92eb8f5](https://github.com/WayfarerLabs/agentworks/commit/92eb8f53b891c26103f4c9bbc97f799938a4915a))
+* rekey uses run_detached for resilient logout+rejoin on Azure ([fae1d7d](https://github.com/WayfarerLabs/agentworks/commit/fae1d7dd2eb5459462dccb86c00d536b5ec84548))
+* rekey uses simple synchronous run, not run_detached ([03acbb2](https://github.com/WayfarerLabs/agentworks/commit/03acbb22340ee8e9dd51fd3554a8a4289594984d))
+* reliable rekey sequence -- restart, logout, login, restart with stabilization pauses ([cdd7a00](https://github.com/WayfarerLabs/agentworks/commit/cdd7a004551b4379c01e6a860e391330983fed10))
+* reliable rekey sequence for Azure and Lima VMs ([cef6a6b](https://github.com/WayfarerLabs/agentworks/commit/cef6a6bfa4c3c5dce104fbc132e07499f71dc6ca))
+* remove ANSI escape codes from prompt_secret masking ([819511d](https://github.com/WayfarerLabs/agentworks/commit/819511d5e518c10e6b40563994b2b543c58c4ff8))
+* remove boot_id cache, use sudo=True for socket rm, validate all PID values in DB, stale comment ([21f34ba](https://github.com/WayfarerLabs/agentworks/commit/21f34ba5e58d2ca03af39d6720082cbbead8a9f5))
+* remove claude from sample user_install_commands, add config validation tests ([1d4a8ef](https://github.com/WayfarerLabs/agentworks/commit/1d4a8effc8d5b1577e87d4b4f064af0d5c602fe1))
+* remove dead _effective_socket_path, fix ensure_pids_batch re-fetch and ambiguity, SSH error handling ([020cf6c](https://github.com/WayfarerLabs/agentworks/commit/020cf6c10a5cba220fe7c9fff5f453022010dc12))
+* remove marketplace prior to installing for nerf claude plugin ([0810e30](https://github.com/WayfarerLabs/agentworks/commit/0810e3029dd10544436933b83a5165b3f52395fd))
+* remove stale sample config, log claude check, add agent template test ([27cc6bc](https://github.com/WayfarerLabs/agentworks/commit/27cc6bce425e9bff8124841fed2da0bbb5d12eba))
+* remove sudo from tmux session commands (BROKEN detection needs real permissions), fix kill propagation ([abd9719](https://github.com/WayfarerLabs/agentworks/commit/abd97192996b0e17f10607c1726c7c117b9d9e2c))
+* rename catalog local vars to avoid ambiguous user terminology ([c90c269](https://github.com/WayfarerLabs/agentworks/commit/c90c2699b94206c1e5f83a2e0675a27605ac7feb))
+* rename prompt_bool back to confirm, handle Ctrl-C in choose ([ff16620](https://github.com/WayfarerLabs/agentworks/commit/ff1662098e1e4016998fcb1985723f754e19e428))
+* rename task to session in vm backup module ([2367962](https://github.com/WayfarerLabs/agentworks/commit/23679625918e580c81c3f024efe28e2fa7bf4b58))
+* replace warnings.warn with stderr print for clean user-facing config warnings ([3f1cb41](https://github.com/WayfarerLabs/agentworks/commit/3f1cb41ae8e1f1d32eb9373459d9a658b1be06f6))
+* resolve all pre-existing lint, type, spelling, and markdown errors ([234096f](https://github.com/WayfarerLabs/agentworks/commit/234096f2ed553a6bf2d87705f4ad2d9e90fcfb72))
+* respect dotfiles ref on reinit pull path ([f002687](https://github.com/WayfarerLabs/agentworks/commit/f002687ff9be98563584bf1427c9c39da460b78d))
+* restart --all is atomic -- cancel aborts entirely, not partial ([27afff2](https://github.com/WayfarerLabs/agentworks/commit/27afff2da27a82d670790fff3a479e56ea424dbc))
+* restore indent=2 on backup archive path details ([2a32f0d](https://github.com/WayfarerLabs/agentworks/commit/2a32f0dbe11150bf6c69a29add787dc8934300a0))
+* retry message wording, extract stabilize_secs constant ([f1a25e5](https://github.com/WayfarerLabs/agentworks/commit/f1a25e52de5209a70209d474dc63c44d93fe4e43))
+* run tailscale logout on azure via nohup ([21bb259](https://github.com/WayfarerLabs/agentworks/commit/21bb259f9cd253948b024c97c467ed03b1a8c381))
+* run task commands in a login shell ([cf98a40](https://github.com/WayfarerLabs/agentworks/commit/cf98a40c93d1681cb6409c47c1cc366b2ed729ea))
+* separate --yes (skip prompts) from --force (kill broken) on restart ([caf17b6](https://github.com/WayfarerLabs/agentworks/commit/caf17b60ba29512c1a9eb2ecda3db685fdf8c63a))
+* separate file and dir acls workspace repair and rehome ([608b4d5](https://github.com/WayfarerLabs/agentworks/commit/608b4d5c557d61deddfbb356dcaa06f5fb27d611))
+* set SGID on workspace subdirectories for correct group inheritance ([016893b](https://github.com/WayfarerLabs/agentworks/commit/016893ba5444aa793faf1e959497d24f675cb87e))
+* shell quoting, type validation, and consistent config issue reporting ([9b31d55](https://github.com/WayfarerLabs/agentworks/commit/9b31d557c4082baf1049a1df596802bfd21bb86e))
+* show '-' for sessions with no status available (VM unreachable) ([0f92fb3](https://github.com/WayfarerLabs/agentworks/commit/0f92fb3f8dad10299d0219df088de8e851379f6d))
+* show agent name in session list mode column ([789547f](https://github.com/WayfarerLabs/agentworks/commit/789547fb7c79facf807d971615055cb25f388d62))
+* skip BROKEN without force, abort delete on unstoppable sessions, safe survivor check ([3725798](https://github.com/WayfarerLabs/agentworks/commit/3725798ad53feba22d0f9ce13b1d2b10bc6bd841))
+* strict dispatch in batch_check_status, PID capture is best-effort (no orphaned sessions) ([dfe56d4](https://github.com/WayfarerLabs/agentworks/commit/dfe56d40f06bcc282ecadb5aac4e387f001b0775))
+* stub Proxmox admin_exec_target with NotImplementedError ([1067c18](https://github.com/WayfarerLabs/agentworks/commit/1067c18e55f70cd4645c1b8f2b3c7bca86095085))
+* sudo on socket existence check, tailor --force hint, validate socket path prefix before rm ([8b701a6](https://github.com/WayfarerLabs/agentworks/commit/8b701a6aab863ac408c15921f5037e023d8bb782))
+* suppress legacy warning during stop and restart ([fd8d30d](https://github.com/WayfarerLabs/agentworks/commit/fd8d30d0bb4395d0352732b3ad5b66ca5611441d))
+* supress socket dir warning on new stuff ([ead3e00](https://github.com/WayfarerLabs/agentworks/commit/ead3e0041f5f15d84c62171420fe54828d091a42))
+* supress socket dir warning on new stuff ([df4d649](https://github.com/WayfarerLabs/agentworks/commit/df4d64952d3eb4b3ad7ee02c9c7ec94ba0068397))
+* surface config issues as warnings via load_config(warn_issues=True) ([6cf4078](https://github.com/WayfarerLabs/agentworks/commit/6cf4078f7dbb62141b84a976ecf850678d0cea3e))
+* type _check_config as Config, add doctor unit tests ([c4705e6](https://github.com/WayfarerLabs/agentworks/commit/c4705e6a768a13ef28b9055d29f5e7efe4d3e3ed))
+* TyperHandler.choose re-prompts on invalid input instead of exiting ([e3e49df](https://github.com/WayfarerLabs/agentworks/commit/e3e49df6fd0d58dffc0c5b8a8173918545250274))
+* UNKNOWN when boot_id unreadable (no unsafe BROKEN), batch boot_id handling, tests for edge cases ([6614db7](https://github.com/WayfarerLabs/agentworks/commit/6614db70e05e6486bdcfb3140fe3fcb228811bda))
+* use /proc for PID liveness (no sudo needed), catch active-socket error in restart ([073d341](https://github.com/WayfarerLabs/agentworks/commit/073d341d664acf3214239590924200903683d129))
+* use direct SSH subprocess and variadic args for vm exec ([e5ba383](https://github.com/WayfarerLabs/agentworks/commit/e5ba383f01ed844dc9de40198fc000c82168dec7))
+* use double-dash separator in migration for collision safety and tmux compatibility ([e658c9e](https://github.com/WayfarerLabs/agentworks/commit/e658c9ebfeee6a0cfdbe62f0d0ac2537791e4e63))
+* use force-confnew instead of force-confold for fresh VMs ([4ab92de](https://github.com/WayfarerLabs/agentworks/commit/4ab92de3e3b9debbece9d9587a53f114b0f964fc))
+* use ipaddress.IPv4Address for strict IP validation in rekey and _join_tailscale ([3c3ddfc](https://github.com/WayfarerLabs/agentworks/commit/3c3ddfc7ed08b329a77007d436e0150ce3a5c2d8))
+* use mode 2771 on socket root so agents can traverse to their own subdirectory ([034915d](https://github.com/WayfarerLabs/agentworks/commit/034915d2a64ee20af3a035006d709dfe51b6441d))
+* use noninteractive apt and force-confold to prevent dpkg prompts ([f45bc5f](https://github.com/WayfarerLabs/agentworks/commit/f45bc5f7361aad4ac203906e200b240adcd33a87))
+* use per-command sudo calls and add run_as_root_multi helper ([47b6d0e](https://github.com/WayfarerLabs/agentworks/commit/47b6d0e4582eb93df66c8503b2cd1f837cdb222e))
+* use sudo -n su --login for correct agent shell environment ([0936e2a](https://github.com/WayfarerLabs/agentworks/commit/0936e2ac1b6c7aa88df008e95656d47f9e0648ee))
+* use sudo for chmod on agent-owned socket after session creation ([36186b5](https://github.com/WayfarerLabs/agentworks/commit/36186b58ecb01371e49a2f0252c3290959707510))
+* use sudo for has-session and sg for attach in console wrappers ([0e8ec79](https://github.com/WayfarerLabs/agentworks/commit/0e8ec79d7f414f94be6d42ff9e6bffd39643bf4b))
+* use sudo for non-interactive tmux operations on agent sockets ([263450b](https://github.com/WayfarerLabs/agentworks/commit/263450bbaeb1b0c3bab6cb34ea59136252ea6761))
+* use usermod to set shell and avoid password prompt ([172cceb](https://github.com/WayfarerLabs/agentworks/commit/172ccebd5001ea55438be7f011eda81450beb691))
+* verify PID dead before socket cleanup, warn about unknown sessions in stop --all ([e840445](https://github.com/WayfarerLabs/agentworks/commit/e8404450f708b4a231973f8c5e9745b1260b0eb1))
+* warn about unknown sessions in list output, suggest repair ([fc7a0a3](https://github.com/WayfarerLabs/agentworks/commit/fc7a0a33a99a4c22ca0dc3524bb1a04609cf2787))
+* warn instead of fail when agent dotfiles pull has local changes ([a008341](https://github.com/WayfarerLabs/agentworks/commit/a008341f6f845234ed04e8860952d1671effd892))
+* warn on usermod failure in ensure_agent_socket_root fast path ([b535ade](https://github.com/WayfarerLabs/agentworks/commit/b535ade14225e7ea03e975f1573ba6451a081d38))
+* workspace repair bug regarding group ownership ([1666788](https://github.com/WayfarerLabs/agentworks/commit/166678897cee1b609db74d04543358a8a8dfa6d5))
+* wrap compound shell commands in sh -c for sudo compatibility ([70e7fae](https://github.com/WayfarerLabs/agentworks/commit/70e7faed5e4e620e957b6e288ced7b5c4b1fd340))
+
+
+### Performance Improvements
+
+* batch C-c then single grace period for stop --all ([45e6315](https://github.com/WayfarerLabs/agentworks/commit/45e631545e59c4029365fcd75d30fb59ddda5659))
+
+
+### Reverts
+
+* remove sg/sudo workarounds from console wrappers ([76d8e10](https://github.com/WayfarerLabs/agentworks/commit/76d8e10717f2eb389441a229f576e87db8a6d853))
+
+
+### Documentation
+
+* add missing proxmox section to config reference in README ([cd8ba1f](https://github.com/WayfarerLabs/agentworks/commit/cd8ba1f4493337c105244c59493496cc49327a9d))
+* add SSH to Tightly Integrated Tools section ([e70d82c](https://github.com/WayfarerLabs/agentworks/commit/e70d82c1ee4a72b6b6eff11e39af96d9cf8e53be))
+* align all --force/--yes semantics in code, SDD, and help text ([51a99b5](https://github.com/WayfarerLabs/agentworks/commit/51a99b564dcf636f1848169b5e0251ebdbfebd47))
+* comment explaining remaining typer.echo in session_logs ([4aacc64](https://github.com/WayfarerLabs/agentworks/commit/4aacc643c2b94d70f296d38b131c9a8ae46ccfd9))
+* doc cleanup ([8ebca80](https://github.com/WayfarerLabs/agentworks/commit/8ebca80a1cd4680cb5a40ab0bf95b9a1507a03ea))
+* explain C-c vs kill-session tradeoff in stop path ([4342fcf](https://github.com/WayfarerLabs/agentworks/commit/4342fcf24658c14263e9cded2c7d2b094ff930bf))
+* generalize vm rekey description beyond account switching ([cecf7ab](https://github.com/WayfarerLabs/agentworks/commit/cecf7abe2eac3d52416ba52f36847329095aae70))
+* improve readme with additional context ([1d1c5ca](https://github.com/WayfarerLabs/agentworks/commit/1d1c5ca2fcb26a35d2c375d4d921caac5b64bc48))
+* move Tailscale and tmux content into Tightly Integrated Tools section ([a32c4b1](https://github.com/WayfarerLabs/agentworks/commit/a32c4b12864bb8792a420d2cc63cc255d6c59b3f))
+* note typer.echo layering violation as future cleanup ([d922ad1](https://github.com/WayfarerLabs/agentworks/commit/d922ad1f506c8f7ed7de1cfe611b24620c3c67e9))
+* **remote-exec:** document as_root preference and add timeout test ([c227746](https://github.com/WayfarerLabs/agentworks/commit/c2277462fad7cb1bc4d9a3817664757dbaf4eced))
+* rewrite README and completions for task-to-session rename ([52e1883](https://github.com/WayfarerLabs/agentworks/commit/52e188300ae1b66e95ff45101bfde5474c0e81ed))
+* update docs based on latest changes ([1f1a8ff](https://github.com/WayfarerLabs/agentworks/commit/1f1a8ff33e2a1a675d92ee16908fbd8c02380ba3))