Skip to content

Add rein to Agent infrastructure#137

Open
SalzDevs wants to merge 1 commit into
bradAGI:mainfrom
SalzDevs:add-rein
Open

Add rein to Agent infrastructure#137
SalzDevs wants to merge 1 commit into
bradAGI:mainfrom
SalzDevs:add-rein

Conversation

@SalzDevs

Copy link
Copy Markdown

What

Adds rein to the Agent infrastructure section.

Why this section

rein is a Go library + CLI that gives AI coding agents reliable shell execution. The four problems every agent framework has with shell commands:

  1. Leaked child processes when the agent crashes (npm run dev keeps running, holds the port)
  2. SIGKILL with no SIGTERM grace → database connections dropped, dirty shutdown
  3. PTY allocation for interactive commands (vim, REPLs, anything that needs a TTY)
  4. Idle-timeout detection → kills processes that stalled on dead TCP

rein gives you all four with one API (rein.Run / rein.Start), plus an overflow policy (Block / DropNewest / DropOldest) for the output channel.

The CLI speaks NDJSON over stdio, so any agent framework (Claude Code, Codex, OpenCode, Goose, Aider) can drive it. Python and Node clients are in the repo.

How it compares to existing entries in this section

  • agent-lsp (Go, MIT) — type-aware language intelligence for agents. Same shape (Go library that agents use), MIT licensed.
  • agenttrace (Go) — local-first session log inspector.
  • gate4agent (Rust, MIT) — "Universal transport library for CLI AI agents. Pipe/NDJSON, PTY, and ACP (JSON-RPC 2.0) modes." — rein is essentially gate4agent's mirror in Go.

Quality

  • A+ on Go Report Card
  • Race-clean: go test -race -count=1 ./... passes
  • CI green on Linux, macOS, Windows
  • v0.1.0 tagged and released
  • 41 commits, MIT licensed
  • Honest about Windows limitations (ConPTY is on the v0.2 roadmap)

Checklist

  • CLI/terminal interface (yes, rein binary + library)
  • Can be used by agents to run commands (yes, that's the point)
  • Valid, active project (just shipped v0.1.0, actively maintained)
  • Placed at the bottom of the section (0 stars, sorted correctly)
  • 1-line description following the entry format
  • License noted (MIT)

rein is a Go library and CLI that gives AI coding agents
the four things every agent gets wrong with shell
execution: process group isolation (no leaked child
processes on agent crash), graceful SIGTERM→SIGKILL
shutdown (so database connections aren't dropped),
PTY allocation (for 'npm run dev'-style commands), and
idle-timeout detection (kills silent stalls on dead
TCP). The CLI speaks NDJSON over stdio so any agent
framework can drive it, and Python and Node clients
are included.

Cross-platform: Linux, macOS, Windows (non-PTY sessions;
ConPTY is on the v0.2 roadmap). MIT licensed, race-clean
test suite, A+ on Go Report Card, CI green on all three
platforms.

Best fit for the 'Agent infrastructure' section alongside
agent-lsp, agenttrace, and gate4agent (which is rein's
mirror in Rust).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant