About
Handwork is the coding harness around the model.
I am Connor Love. I built Handwork to see how small and direct a terminal coding agent could be without giving up the tools needed for real project work.
01
What a harness does
The model supplies the reasoning. Handwork supplies the working environment around it. It gathers project context, sends requests to the model, turns tool calls into local actions, returns the results, and continues the task.
That environment includes the terminal interface, file and code search, edits, shell commands, permission reviews, project instructions, skills, MCP connections, subagents, and saved conversations.
Handwork's native path runs its own agent loop across several model providers. Its Codex and Copilot adapters run those providers' official agent engines inside the same terminal interface.
02
Why I built it
While using tools such as Codex and Claude Code, I noticed how much memory a coding session could keep resident. I wanted to find out how much of that local footprint was necessary and how much a smaller native client could avoid.
Memory was the starting point, not the only goal. A coding agent stays open for long sessions, runs many tools, and holds a growing conversation. I wanted quick startup, short waits between tool actions, and a terminal that stays responsive as the session grows.
I wrote the agent runtime and terminal in Zig for direct control over allocations, process management, and rendering. The JavaScript SDK remains available for applications that need their own interface, tools, or authentication.
03
What I have measured
In three small TypeScript pilots, frozen Handwork builds used 31.1 to 41.8 MiB of median peak agent RSS. Codex used 214.0 to 229.8 MiB, and OpenCode used 757.2 to 811.3 MiB. All three agents completed every recorded attempt.
Those numbers cover the local agent process tree, not the hosted model. Codex had the lower median completion time on all three tasks. Claude Code was not measured, so I do not make a numerical comparison against it.
The samples are small and do not rank the tools across other projects. The published pilots include the machine, versions, prompts, methods, caveats, and source data.
04
Current release 0.0.9
The npm package supports macOS on Apple Silicon. The repository includes source builds, a JavaScript SDK, and official Codex and Copilot runtime adapters.
Handwork does not replace the model. The quality of a result still depends on the selected model, the task, the project context, and the checks used to verify the work.
Handwork can change files and run programs. Check the permission mode before a task. Review the diff and test results after it finishes.
05
Links
Read the code, report an issue, or learn more about the person behind Handwork.