From 7166977c5aa41579ee77f8d1a85017c9cd7f45c0 Mon Sep 17 00:00:00 2001
From: Yaroslav Halchenko <debian@onerussian.com>
Date: Sat, 24 Jan 2026 22:09:33 -0500
Subject: [PATCH 1/5] Add github action to codespell main on push and PRs

---
 .github/workflows/codespell.yml | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)
 create mode 100644 .github/workflows/codespell.yml

diff --git a/.github/workflows/codespell.yml b/.github/workflows/codespell.yml
new file mode 100644
index 000000000..c59e04737
--- /dev/null
+++ b/.github/workflows/codespell.yml
@@ -0,0 +1,25 @@
+# Codespell configuration is within .codespellrc
+---
+name: Codespell
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  codespell:
+    name: Check for spelling errors
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Annotate locations with typos
+        uses: codespell-project/codespell-problem-matcher@v1
+      - name: Codespell
+        uses: codespell-project/actions-codespell@v2

From b67bf711998d32e9cb2ff9ec34bbf2b0e524c9e6 Mon Sep 17 00:00:00 2001
From: Yaroslav Halchenko <debian@onerussian.com>
Date: Sat, 24 Jan 2026 22:09:33 -0500
Subject: [PATCH 2/5] Add rudimentary codespell config

---
 .codespellrc | 6 ++++++
 1 file changed, 6 insertions(+)
 create mode 100644 .codespellrc

diff --git a/.codespellrc b/.codespellrc
new file mode 100644
index 000000000..51c4dc024
--- /dev/null
+++ b/.codespellrc
@@ -0,0 +1,6 @@
+[codespell]
+# Ref: https://github.com/codespell-project/codespell#using-a-config-file
+skip = .git*,*.svg,package-lock.json,vendor,*-lock.yaml,*.css,.codespellrc
+check-hidden = true
+# ignore-regex = 
+# ignore-words-list =

From d782cc415658c094c7f32ca1f6253f9b8e1dce40 Mon Sep 17 00:00:00 2001
From: Yaroslav Halchenko <debian@onerussian.com>
Date: Sat, 24 Jan 2026 22:14:11 -0500
Subject: [PATCH 3/5] Update codespell config to reduce false positives

- Skip build artifacts: dist, a2ui bundle, .cache, .npm
- Skip creative writing: *.prose files
- Ignore technical terms: ANSI sequences, Windows flags, variable names
---
 .codespellrc | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/.codespellrc b/.codespellrc
index 51c4dc024..41cb73a3a 100644
--- a/.codespellrc
+++ b/.codespellrc
@@ -1,6 +1,7 @@
 [codespell]
 # Ref: https://github.com/codespell-project/codespell#using-a-config-file
-skip = .git*,*.svg,package-lock.json,vendor,*-lock.yaml,*.css,.codespellrc
+skip = .git*,*.svg,package-lock.json,vendor,*-lock.yaml,*.css,.codespellrc,dist,*.caf,*/a2ui/*,.cache,*.prose,.npm
 check-hidden = true
-# ignore-regex = 
-# ignore-words-list =
+# Ignore camelCase and PascalCase identifiers (common in code)
+ignore-regex = \b[a-z]+[A-Z]\w*\b|\b[A-Z][a-z]+[A-Z]\w*\b
+ignore-words-list = inout,rouge,statics,caf,afterall,cript,fro,nd,ot,fo

From 13f79d1f59010ff66236754a0aba8947389d1527 Mon Sep 17 00:00:00 2001
From: Yaroslav Halchenko <debian@onerussian.com>
Date: Sat, 24 Jan 2026 22:14:37 -0500
Subject: [PATCH 4/5] chore: add .npm/ to gitignore

---
 .gitignore | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.gitignore b/.gitignore
index b2c1de9a2..2a52efe7c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -69,3 +69,4 @@ USER.md
 
 # local tooling
 .serena/
+.npm/

From 524d17102beff2c83de0a46c9630c9af5968f6f2 Mon Sep 17 00:00:00 2001
From: Yaroslav Halchenko <debian@onerussian.com>
Date: Sat, 24 Jan 2026 22:14:44 -0500
Subject: [PATCH 5/5] [DATALAD RUNCMD] chore: fix typos with codespell

Fixed typos:
- re-use -> reuse (docs/token-use.md, src/commands/agent/session.ts)
- overlayed -> overlaid (docs/tools/browser.md)
- assistent -> assistant (extensions/open-prose/skills/prose/guidance/antipatterns.md)
- thats -> that's (test files)

=== Do not change lines below ===
{
 "chain": [],
 "cmd": "uvx codespell -w",
 "exit": 0,
 "extra_inputs": [],
 "inputs": [],
 "outputs": [],
 "pwd": "."
}
^^^ Do not change lines above ^^^
---
 docs/token-use.md                             |  2 +-
 docs/tools/browser.md                         |  4 ++--
 .../skills/prose/guidance/antipatterns.md     |  2 +-
 src/auto-reply/model.test.ts                  |  4 ++--
 src/auto-reply/reply.directive.parse.test.ts  | 20 +++++++++----------
 src/commands/agent/session.ts                 |  2 +-
 6 files changed, 17 insertions(+), 17 deletions(-)

diff --git a/docs/token-use.md b/docs/token-use.md
index f73bbb970..0fc4e170d 100644
--- a/docs/token-use.md
+++ b/docs/token-use.md
@@ -69,7 +69,7 @@ never show dollar cost.
 
 Provider prompt caching only applies within the cache TTL window. Clawdbot can
 optionally run **cache-ttl pruning**: it prunes the session once the cache TTL
-has expired, then resets the cache window so subsequent requests can re-use the
+has expired, then resets the cache window so subsequent requests can reuse the
 freshly cached context instead of re-caching the full history. This keeps cache
 write costs lower when a session goes idle past the TTL.
 
diff --git a/docs/tools/browser.md b/docs/tools/browser.md
index 3bf597e33..9160c0d8a 100644
--- a/docs/tools/browser.md
+++ b/docs/tools/browser.md
@@ -517,7 +517,7 @@ Notes:
   - Role snapshot options (`--interactive`, `--compact`, `--depth`, `--selector`) force a role-based snapshot with refs like `ref=e12`.
   - `--frame "<iframe selector>"` scopes role snapshots to an iframe (pairs with role refs like `e12`).
   - `--interactive` outputs a flat, easy-to-pick list of interactive elements (best for driving actions).
-  - `--labels` adds a viewport-only screenshot with overlayed ref labels (prints `MEDIA:<path>`).
+  - `--labels` adds a viewport-only screenshot with overlaid ref labels (prints `MEDIA:<path>`).
 - `click`/`type`/etc require a `ref` from `snapshot` (either numeric `12` or role ref `e12`).
   CSS selectors are intentionally not supported for actions.
 
@@ -534,7 +534,7 @@ Clawdbot supports two “snapshot” styles:
   - Output: a role-based list/tree with `[ref=e12]` (and optional `[nth=1]`).
   - Actions: `clawdbot browser click e12`, `clawdbot browser highlight e12`.
   - Internally, the ref is resolved via `getByRole(...)` (plus `nth()` for duplicates).
-  - Add `--labels` to include a viewport screenshot with overlayed `e12` labels.
+  - Add `--labels` to include a viewport screenshot with overlaid `e12` labels.
 
 Ref behavior:
 - Refs are **not stable across navigations**; if something fails, re-run `snapshot` and use a fresh ref.
diff --git a/extensions/open-prose/skills/prose/guidance/antipatterns.md b/extensions/open-prose/skills/prose/guidance/antipatterns.md
index fef0e41d0..a806b878f 100644
--- a/extensions/open-prose/skills/prose/guidance/antipatterns.md
+++ b/extensions/open-prose/skills/prose/guidance/antipatterns.md
@@ -568,7 +568,7 @@ session "You are a helpful assistant. Analyze this code for bugs."
 # ... later ...
 session "You are a helpful assistant. Analyze this code for bugs."
 # ... even later ...
-session "You are a helpful assistent. Analyze this code for bugs."  # Typo!
+session "You are a helpful assistant. Analyze this code for bugs."  # Typo!
 ```
 
 **Why it's bad**: Inconsistency when updating. Typos go unnoticed.
diff --git a/src/auto-reply/model.test.ts b/src/auto-reply/model.test.ts
index 4a5aa7714..462e97696 100644
--- a/src/auto-reply/model.test.ts
+++ b/src/auto-reply/model.test.ts
@@ -115,9 +115,9 @@ describe("extractModelDirective", () => {
 
   describe("edge cases", () => {
     it("absorbs path-like segments when /model includes extra slashes", () => {
-      const result = extractModelDirective("thats not /model gpt-5/tmp/hello");
+      const result = extractModelDirective("that's not /model gpt-5/tmp/hello");
       expect(result.hasDirective).toBe(true);
-      expect(result.cleaned).toBe("thats not");
+      expect(result.cleaned).toBe("that's not");
     });
 
     it("handles alias with special regex characters", () => {
diff --git a/src/auto-reply/reply.directive.parse.test.ts b/src/auto-reply/reply.directive.parse.test.ts
index 545c5e169..8de068c06 100644
--- a/src/auto-reply/reply.directive.parse.test.ts
+++ b/src/auto-reply/reply.directive.parse.test.ts
@@ -152,33 +152,33 @@ describe("directive parsing", () => {
   });
 
   it("preserves spacing when stripping think directives before paths", () => {
-    const res = extractThinkDirective("thats not /think high/tmp/hello");
+    const res = extractThinkDirective("that's not /think high/tmp/hello");
     expect(res.hasDirective).toBe(true);
-    expect(res.cleaned).toBe("thats not /tmp/hello");
+    expect(res.cleaned).toBe("that's not /tmp/hello");
   });
 
   it("preserves spacing when stripping verbose directives before paths", () => {
-    const res = extractVerboseDirective("thats not /verbose on/tmp/hello");
+    const res = extractVerboseDirective("that's not /verbose on/tmp/hello");
     expect(res.hasDirective).toBe(true);
-    expect(res.cleaned).toBe("thats not /tmp/hello");
+    expect(res.cleaned).toBe("that's not /tmp/hello");
   });
 
   it("preserves spacing when stripping reasoning directives before paths", () => {
-    const res = extractReasoningDirective("thats not /reasoning on/tmp/hello");
+    const res = extractReasoningDirective("that's not /reasoning on/tmp/hello");
     expect(res.hasDirective).toBe(true);
-    expect(res.cleaned).toBe("thats not /tmp/hello");
+    expect(res.cleaned).toBe("that's not /tmp/hello");
   });
 
   it("preserves spacing when stripping status directives before paths", () => {
-    const res = extractStatusDirective("thats not /status:/tmp/hello");
+    const res = extractStatusDirective("that's not /status:/tmp/hello");
     expect(res.hasDirective).toBe(true);
-    expect(res.cleaned).toBe("thats not /tmp/hello");
+    expect(res.cleaned).toBe("that's not /tmp/hello");
   });
 
   it("does not treat /usage as a status directive", () => {
-    const res = extractStatusDirective("thats not /usage:/tmp/hello");
+    const res = extractStatusDirective("that's not /usage:/tmp/hello");
     expect(res.hasDirective).toBe(false);
-    expect(res.cleaned).toBe("thats not /usage:/tmp/hello");
+    expect(res.cleaned).toBe("that's not /usage:/tmp/hello");
   });
 
   it("parses queue options and modes", () => {
diff --git a/src/commands/agent/session.ts b/src/commands/agent/session.ts
index 60860f0ec..a8c1d0616 100644
--- a/src/commands/agent/session.ts
+++ b/src/commands/agent/session.ts
@@ -65,7 +65,7 @@ export function resolveSessionKeyForRequest(opts: {
   let sessionKey: string | undefined =
     explicitSessionKey ?? (ctx ? resolveSessionKey(scope, ctx, mainKey) : undefined);
 
-  // If a session id was provided, prefer to re-use its entry (by id) even when no key was derived.
+  // If a session id was provided, prefer to reuse its entry (by id) even when no key was derived.
   if (
     !explicitSessionKey &&
     opts.sessionId &&