awsh

Reviewed at commit 750b81e New version, not yet reviewed

Caution: Saves session summaries to ~/.aither/focus, lets a delegated harness edit your files, and at session start runs awgit to add commit hooks, on Windows even an awgit in the project.

Sends data to The model backends your local awsh daemon routes to (such as Gemini, Codex, OpenCode, Aider, Kimi or DeepSeek, depending on your daemon configuration)

awsh for Claude Code: an `aw` subagent type whose model steps are answered by a session on the local awsh harness daemon, so any harness and any backend the…

Made by
Aitherium
What we checked

Adds an aw subagent type: its task, plus your working directory, goes to a separate awsh daemon on your machine, which runs another coding harness or model backend that can edit files. Also ships about 110 Aither skills, an output style, four MCP servers and hooks that save session summaries to ~/.aither/focus, pass prompts to optional local tools and install awgit commit hooks in your repositories when awgit is installed.

Review details

Static review of the source at the pinned commit; not run. Delta review of the changes since 6d033e4; the rest carries over from the review at that commit. Changes in this version are prompt text and one small script edit: new skills aitherbrowser, awdesk, i-have-adhd, salescompel and zeroauthy are on-demand documentation without allowed-tools (they describe enabling a local browser addon with adk, installing the awdesk tray app from GitHub releases or source with npm, building SalesCompel from source with go, and running the zeroauthy container image pinned from ghcr.io); the awvoice skill gained a paragraph on its conversation loop; the aither output style gained formatting rules for readers with ADHD (lead with the next action, cap lists at five); scripts/session-focus.py now reads the gaming lock as utf-8-sig and treats a lock of kind sleep as not gaming. No new hooks, hosts or permissions. Module registers session.start (registers a no-op aw_progress tool), tool.call (answers or denies aw_progress), agent.spawn, session.end and turn.step. For aw subagents, turn.step sends the spawn prompt to the awsh daemon over $.http.fetch at http://AITHER_HARNESS_HOST:AITHER_HARNESS_PORT (default 127.0.0.1:8362) with the bearer token from ~/.aither/harness_token (or AITHER_HARNESS_TOKEN_FILE), creates a session with the cwd, harness, backend, model and permission_mode from ~/.aither/mods.json, streams events back as the subagent's output and deletes sessions at session.end. It reads the subagent transcript under ~/.claude/projects to pick up follow-up messages. Harnesses run their own tools in the project directory. New in this version: hooks/awgit_ensure.py (stdlib only, always exits 0, never blocks) runs at SessionStart for the session's repository and at PreToolUse on Bash and PowerShell before the first git commit it detects per repository per session, and runs awgit hooks ensure --repo <dir> --quiet, which by the file's own account installs or upgrades chained commit hooks (stale-revert and mass-delete guards that can refuse a commit; existing hooks kept as <hook>.org). It keeps a small per-session cache file in the temp folder, is a no-op without awgit, and AWGIT_ENSURE_DISABLE=1 turns it off. awgit is a separate package outside this repository, so what hooks ensure writes was not reviewed. The program is found with shutil.which('awgit'), and CPython's documented Windows behaviour searches the current directory first, so on Windows an awgit.exe, .cmd or .bat at the root of an opened repository would run at session start without awgit being installed; this follows from reading the code and was not tested. session.start also gained keepHookd: it reads the hooks in Claude settings through $.settings.read, and only when one routes to 127.0.0.1:<port>/run? it fetches /health on that port and, when there is no answer, runs python -m adk.harnesses.hookd ensure --port <port> with a 20 second timeout. adk/harnesses/hookd.py in the installed awdk package (read in the clone) then starts a detached, console-less hook runner on 127.0.0.1 that outlives the session. No settings route to hookd unless you ran adk claude hookd convert --write yourself. session-focus.py gained a Game on mode: it reads ~/.aither/posture.json and ~/.aither/gaming.lock and, while gaming, parses only the last 2 MB of the transcript and skips the push; no new data or destination. The aither output style, which you have to select, now tells Claude to send exploration to research, recall, brief and ask_aither on an aither-local MCP server, which can write files; that server is registered by adk claude setup, is not part of this plugin and was not reviewed. Its skill says it keeps briefs in ~/.aither/crystal and traces in ~/.aither/agent-trace and may use a DeepSeek model. New skills claude-code-hooks-fast, lan-latency, local-research, ps5-bridge, windows-kernel-leak and worktrees are on-demand documentation without allowed-tools; they describe commands such as rewriting settings.json with a backup, turning off network adapter power saving and Wi-Fi, kernel debug mode and Secure Boot changes, an hourly worktree reaper and driving a PS5 game you dumped yourself. Carried over: hooks/portable.json runs awrelay hookgate after every tool use, sends the first 200 characters of each prompt to the awm CLI when AWM_SCOPE is set, and pipes the Stop payload to awvoice reply; each is a no-op when that tool is missing. scripts/session-focus.py runs at SessionStart, UserPromptSubmit and Stop: it parses the transcript, redacts common secret patterns, and writes first and latest ask, edited file paths and the closing report to ~/.aither/focus, injects recent records and announcements (including text from the repo's .claude/announcements) as context, and has a detached push that needs a stop-auto-capture.py gateway client that is not part of this plugin, so it does nothing here. .mcp.json starts four servers with python -m adk.harnesses.brick_mcp from an installed awdk package that is not included. Skills are on-demand documentation, several with allowed-tools Bash or Write, and some describe curl-pipe-to-shell installs and settings rewrites.

What it uses
  • Reads your prompts: yes
  • Sees tool calls: yes
  • Blocks or changes tool calls: yes
  • Reads or writes files: yes
  • Runs programs on your machine: yes
  • Calls the model (uses tokens): no
  • Sends data over the network: yes
  • Stores data: yes
  • Shows something on screen: no

awsh for Claude Code: an `aw` subagent type whose model steps are answered by a session on the local awsh harness daemon, so any harness and any backend the daemon can drive runs as a native Claude Code subagent, streamed live. Also carries the Aither World skills, the `aither` output style, MCP servers for installed bricks and portable brick hooks.

Made this mod? Add a badge to your README

modsforClaude badge for awsh

Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.

[![Listed on modsforClaude](https://modsforclaude.com/badge/awsh.svg)](https://modsforclaude.com/mods/awsh/)

← All mods