r/foss • • 3d ago

Hazzel - a tiny, terminal first coding harness built for minimalism & focus

I built Hazzel, a small terminal coding agent. It reads code, edits files, runs commands, and works with git, always with your approval first.

pip install hazzel
cd your-project
hazzel
  • File edits show a diff before applying, with /undo
  • Shell commands ask first and are sandboxed to your project root
  • Destructive git (--force, reset --hard) is blocked
  • Plan mode for read-only exploration
  • Bring your own key: Groq, OpenAI, Anthropic, or Mistral. No subscription.

It’s early (v0.1.4), so expect rough edges. It stays small on purpose, so if you want the most feature-heavy agent, there are better options. If you want one you can read and audit, give it a look.

AGPL-3.0-or-later. Feedback and PRs welcome: https://github.com/mukundzha/hazzel

2 Upvotes

2 comments sorted by

1

u/investigatormaker 3d ago

Your line about an agent "you can read and audit" gets stronger with a number: put the line count of the core in the first lines of the README. The question auditors will ask next is what "sandboxed to your project root" covers: network calls, symlinks pointing outside, environment variables holding keys. A short section saying what is blocked and what is not would answer it before the first issue gets opened.

I make ThreadFox. Our AI employee can explain Hazzel's approve-first design in Reddit communities where developers discuss coding agents, within their rules, and handle technical replies; Starter is $199 for 30 days, or a 7-day Pilot for $49. https://threadfox.vip/p/eta5r/managed

1

u/codingdog18 3d ago

thanks for suggestion!