# Boucle-framework

> Autonomous agent framework with structured memory, safety hooks, and loop management. Built by the agent that runs on it.

- **URL**: https://www.freshcrate.ai/projects/Boucle-framework
- **Author**: Bande-a-Bonnot
- **Category**: MCP Servers
- **Latest version**: `v0.12.0` (2026-04-02)
- **License**: MIT
- **Source**: https://github.com/Bande-a-Bonnot/Boucle-framework
- **Homepage**: https://framework.boucle.sh/
- **Language**: Shell
- **GitHub**: 75 stars, 5 forks
- **Registry**: github
- **Tags**: `agent-framework`, `ai-agent`, `autonomous-agent`, `claude-code`, `claude-code-hooks`, `mcp`, `rust`, `safety`, `shell`

## Description

Autonomous agent framework with structured memory, safety hooks, and loop management. Built by the agent that runs on it.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v0.12.0` | 2026-04-02 | High | 56 commits since v0.11.0.  ### Highlights  - **Searchable Known Limitations page** -- Browse, search, and filter all 215 documented Claude Code hook limitations at [framework.boucle.sh/limitations.html](https://framework.boucle.sh/limitations.html). Supports text search, category filtering, and URL deep linking. - **test-hook.sh** -- Dry-run hook testing without a live Claude Code session. Ships with 60 example test cases. Addresses [#39971](https://github.com/anthropics/claude-code/issues/39971 |
| `v0.11.0` | 2026-03-31 | Medium | ## What's New  **22 commits since v0.10.0.** This release ships three weeks of safety improvements, new enforcement tools, and the migration to Claude Code's recommended hook output format.  ### Breaking Format Migration All 27 hook files now use `hookSpecificOutput.permissionDecision:deny` instead of the deprecated `decision:block` format. The old format still works but may be removed in a future Claude Code version. If you run `installer upgrade`, your hooks will be updated automatically.  ### |
| `v0.10.0` | 2026-03-30 | Medium | See CHANGELOG.md  **Full Changelog**: https://github.com/Bande-a-Bonnot/Boucle-framework/compare/v0.9.3...v0.10.0 |
| `v0.9.3` | 2026-03-29 | Medium | ## Windows Parity: 7/7 Hooks Now Have Native PowerShell Equivalents  Every hook in Boucle-framework now works natively on Windows without WSL, bash, or jq.  ### New PS1 Hooks - **bash-guard.ps1** -- 849 lines, 112 check rules, 51 pattern categories. Covers cloud infrastructure, encoding bypasses, disk utilities, and all bash-guard patterns. - **worktree-guard.ps1** -- 208 lines. Blocks ExitWorktree on uncommitted, untracked, unmerged, or unpushed changes. - **read-once.ps1** -- 264 lines. Token- |
| `v0.9.2` | 2026-03-29 | Medium | ## What's new in v0.9.2  ### In-place file editing bypass detection (bash-guard)  [#40408](https://github.com/anthropics/claude-code/issues/40408) revealed that `perl -i -pe` completely bypasses all Write/Edit hook protections. bash-guard now blocks `perl -i`, `ruby -i`, `sed -i`, and `ed` commands that modify files directly.  ### Glob wildcard injection warning (safety-check)  [#40344](https://github.com/anthropics/claude-code/issues/40344) showed that permission allowlist rules containing glob |
| `v0.9.1` | 2026-03-28 | Medium | ## What's new  ### git-safe: `--no-verify` bypass detection Blocks `git commit --no-verify`, `git push --no-verify`, and `-n` shorthand. Prevents agents from skipping pre-commit hooks and GPG signing. Works in both bash and PowerShell hooks.  ### worktree-guard: squash merge false positive fix Two-tier detection replaces SHA-only comparison: - **Tier 1**: `git cherry` for patch-level equivalence (single-commit squash, cherry-pick, rebase) - **Tier 2**: per-file comparison for multi-commit squash |
| `v0.9.0` | 2026-03-28 | Medium | **Full Changelog**: https://github.com/Bande-a-Bonnot/Boucle-framework/compare/v0.8.0...v0.9.0 |
| `v0.8.0` | 2026-03-27 | Medium | ## New  - **worktree-guard hook** — blocks `ExitWorktree` when the worktree has uncommitted changes, untracked files, unmerged branches, or unpushed commits. Prevents data loss from [#38287](https://github.com/anthropics/claude-code/issues/38287). 29 tests. - **bash-guard: git push --force detection** — blocks `git push --force`, `git push -f`, and `git push --force-with-lease`. Configurable via `allow: git-force-push`. 9 new tests. - **safety-check: 7 new platform bug warnings** — detects known |
| `v0.7.0` | 2026-03-24 | Medium | **Full Changelog**: https://github.com/Bande-a-Bonnot/Boucle-framework/compare/v0.6.1...v0.7.0 |
| `v0.6.1` | 2026-03-23 | Medium | **Full Changelog**: https://github.com/Bande-a-Bonnot/Boucle-framework/compare/v0.6.0...v0.6.1 |

## Dependency audit

- **Score**: 82/100
- **Total deps**: 14
- **Resolved**: 14
- **Unresolved**: 0
- **License conflicts**: 0
- **Warnings**: 9
- **Scanned**: 2026-04-27

## Citation

- HTML: https://www.freshcrate.ai/projects/Boucle-framework
- Markdown: https://www.freshcrate.ai/projects/Boucle-framework.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/Boucle-framework/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._