ToolsThe story, in brief

Show HN: Pu.sh – a full coding-agent harness in 400 lines of shell

400 lines of shell. No dependencies. A fully functional coding agent that actually works—and you can read (most of) it.

Paper-cut illustration of a coral software window opening into a three-dimensional drafting space.
New tools for building and creating with AI.AI illustration by KeyNews
The KeyNews take

Why it matters

A developer shipped a minimalist, portable AI coding agent that strips away framework bloat and demonstrates that agent loops don't require heavy tooling. It's a contrarian take on agent architecture and a working proof that control and simplicity can coexist with capability.

The key facts

17 to know
  1. ~400 lines of shell script (sub-500 LOC constraint)

  2. 7 tools: bash, read, write, edit, grep, find, ls

  3. Supports both Anthropic and OpenAI APIs

  4. Features: REPL, auto-compaction, checkpoint/resume, pipe mode

  5. 90 no-API tests included

  6. Zero external dependencies—sh, curl, awk only

  7. Inspired by Pi (pi.dev) agent architecture

  8. Published on Hacker News with 63 points

  9. Pu.sh: 400-line shell script coding agent harness

  10. Supports both Anthropic Claude and OpenAI models

  11. 7 integrated tools: bash, read, write, edit, grep, find, ls

  12. Zero external dependencies—uses only sh, curl, awk, system primitives

  13. Features: auto-compaction, checkpoint/resume, pipe mode, 90 no-API tests

  14. Inspired by pi.dev architecture; same 7-tool surface and exact-text edit model

  15. Implements full OpenAI tool-use loop with reasoning items across turns

  16. Originally started as 6 KB proof-of-concept, iterated to sub-500 LOC constraint

  17. Creator used Claude and Codex to write portions of the awk logic

Go to the source

Hacker Newspu.dev

Publisher excerpt: I originally was just messing with pi-autoresearch. Gave it a sample task to build the most portable coding agent. First cut was 6 KB of shell. Great for one-shots, unusable interactively. I was shocked it actually worked. Started building up -- adding features — but with a self-imposed rule: no…
Read original report
Back to today's editionMore tools news

Keep reading

Related stories

More from Tools