From 2fc3f3d006c1ee6e84ca4e27820361291be5b704 Mon Sep 17 00:00:00 2001
From: Micheal Wilkinson <micheal.wilkinson@createfuture.com>
Date: Fri, 20 Mar 2026 18:00:13 +0000
Subject: [PATCH] docs: update exec and exec_all parity notes

---
 README.md    | 10 +++++-----
 changelog.md |  2 ++
 2 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 42e80f2..f713107 100644
--- a/README.md
+++ b/README.md
@@ -53,10 +53,10 @@ Implemented commands:
 - If `<castle>/.homesickrc` exists and `<castle>/.homesick.d/parity.rb` does not, generates `parity.rb` before execution.
 - Never overwrites an existing `parity.rb` wrapper.
 
-Not yet implemented:
+### exec behavior
 
-- `exec`
-- `exec_all`
+- `exec CASTLE COMMAND...` runs the shell command inside the target castle root.
+- `exec_all COMMAND...` runs the same shell command inside each cloned castle root in sorted order.
 
 ## Outstanding Feature Checklist
 
@@ -68,8 +68,8 @@ Command parity:
 - [x] `destroy`
 - [x] `cd`
 - [x] `open`
-- [ ] `exec`
-- [ ] `exec_all`
+- [x] `exec`
+- [x] `exec_all`
 - [x] `generate`
 
 Historical flag/behavior parity:
diff --git a/changelog.md b/changelog.md
index 2e48e75..51dca27 100644
--- a/changelog.md
+++ b/changelog.md
@@ -15,6 +15,8 @@ A `### Breaking` section is used in addition to Keep a Changelog's standard sect
 
 - `rc` command: executes all executable scripts inside a castle's `.homesick.d/` directory in sorted order, with the castle root as the working directory. stdout/stderr from each script is forwarded to the caller.
 - `rc` command: when a `.homesickrc` file exists and no `parity.rb` wrapper is present in `.homesick.d/`, a Ruby wrapper script (`parity.rb`) is generated automatically to preserve backwards compatibility. An existing `parity.rb` is never overwritten.
+- `exec` command: runs a shell command inside the target castle root directory.
+- `exec_all` command: runs a shell command inside each cloned castle root directory in sorted order.
 - Native Go implementations for `clone`, `link`, `unlink`, `track`, `pull`, `push`, `commit`, `destroy`, `cd`, `open`, and `generate`.
 - Containerized behavior test suite for command parity validation.
 - Dedicated test suites for `list`, `show_path`, `status`, `diff`, and `version`.