Hazzel
A small terminal coding agent. Bring your own key.
Hazzel lives in your terminal. It reads code, edits files, runs commands, and works with git — always with your approval first.
pip install hazzel
cd your-project
hazzel
Run /model, pick a provider, paste your key. Keys are stored at ~/.config/hazzel/config.json with 0600 permissions. Env vars (OPENAI_API_KEY, ANTHROPIC_API_KEY, MISTRAL_API_KEY, GROQ_API_KEY) work too.
❯ Fix the failing test in tests/test_agent.py
● read_file tests/test_agent.py
● edit_file src/hazzel/agent.py
● run_command pytest -q — passed
Why Hazzel?
Most coding agents keep getting bigger. Hazzel stays small on purpose.
The model suggests what to do. Hazzel decides whether and how to do it. Every mutation goes through you: file changes show a diff before they apply, shell commands ask first, and destructive git stays blocked.
If you want the most feature-heavy agent, there are better options. If you want a terminal agent you can see through, that's Hazzel.
What it does
- Read, search, and list your codebase. Tag files with
@pathto put them in context. - Create and edit files with diff preview and approval. Undo with
/undo. - Run shell commands with approval and timeout, sandboxed to your project root. Read-only cmds (
ls,cat,git status…) skip approval. - Plan mode (
/plan on): read-only exploration. Hazzel proposes a numbered plan, changes nothing until you run/plan off. - Prove mode (
/prove on): smoke-checks Python edits in/tmpbefore you trust them. - Git-native:
/status,/diffwith file browser,/commitwith suggested message,/branch,/log,/push,/pull,/sync. No--force, noreset --hardvia shell. - Model thinking stays collapsed behind an Enter-to-expand prompt — peek only when curious.
- Extras:
/initdrafts anAGENTS.mdproject map,/exportsaves the transcript,/copygrabs the last reply,/retryre-runs your last message. - Streams responses with per-turn token usage (
/usage).
Providers
Bring your own key. No subscription.
- Groq (default:
openai/gpt-oss-120b) - OpenAI
- Anthropic
- Mistral
Switch anytime with /model.
What it is not
Early-stage (v0.1.7). Expect rough edges.
No web browsing, no pull requests, no deploys, no background agents, no session persistence across restarts. It doesn't replace your editor — it stays in the terminal next to it.
Contributing
Issues and pull requests welcome.
License
AGPL-3.0-or-later. See LICENSE.
If it fits your workflow, star the repo. It helps other terminal-first developers find it.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file hazzel-0.1.7.tar.gz.
File metadata
- Download URL: hazzel-0.1.7.tar.gz
- Upload date:
- Size: 71.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fc5604845a4dfcd8ce764ca679ace81237ac2929f23571a8cb2da829e06ee7de
|
|
| MD5 |
6c0a0f915d6ad2c483cca314687c52da
|
|
| BLAKE2b-256 |
1616ee070b71dde7b458de8aee8f29d5b64dcf57dcac6d230ec7f3aacacf95c5
|
File details
Details for the file hazzel-0.1.7-py3-none-any.whl.
File metadata
- Download URL: hazzel-0.1.7-py3-none-any.whl
- Upload date:
- Size: 79.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
574c024918be20f4353858416ee60dfe3bcd5126d3b34f2f7d9635a11c75ce99
|
|
| MD5 |
95b0b2896128710d37c8362aab2435c1
|
|
| BLAKE2b-256 |
460fbd98f1ee658bccd80c688eb4e1436e05ff50d9b4d8f39af521c722aab79e
|
