# charmbracelet/crush

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/charmbracelet-crush).**

20,165 stars · 1,245 forks · Go · other

## Links

- GitHub: https://github.com/charmbracelet/crush
- awesome-repositories: https://awesome-repositories.com/repository/charmbracelet-crush.md

## Topics

`agentic-ai` `ai` `llms` `ravishing`

## Description

Crush is a framework designed to orchestrate and secure the execution of external tools invoked by large language models. It functions as a middleware layer that manages the flow of agentic tool calls, providing a controlled environment for terminal-based automation and task processing.

The project distinguishes itself by implementing a policy-driven security layer that intercepts, validates, and modifies tool execution requests. By wrapping command calls within a process-boundary layer, it allows for the automated approval of specific operations and the dynamic injection of contextual metadata into the execution environment.

Beyond its core orchestration capabilities, the tool supports the processing of structured data directly within the command line. This enables the transformation of complex inputs into simplified formats, facilitating the creation of automated data pipelines and secure terminal workflows.

## Tags

### Artificial Intelligence & ML

- [Agentic Tool Orchestration](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-tool-orchestration.md) — Orchestrates and secures the execution of external tools invoked by large language models.
- [AI Agent Orchestration Frameworks](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-agent-orchestration-frameworks.md) — Acts as a framework for managing and automating the execution flow of tools invoked by language models.
- [Execution Message Injection](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-architectures/orchestration-engines/ai-agent/runtime-execution-control/execution-message-injection.md) — Appends instructions and metadata to the execution environment to guide agent behavior. ([source](https://github.com/charmbracelet/crush/tree/main/docs/hooks))

### Development Tools & Productivity

- [Tool Execution Interceptors](https://awesome-repositories.com/f/development-tools-productivity/execution-middleware/tool-execution-interceptors.md) — Intercepts, validates, and modifies tool calls made by AI agents to enforce security policies. ([source](https://github.com/charmbracelet/crush/tree/main/docs/hooks))
- [Terminal Workflow Automations](https://awesome-repositories.com/f/development-tools-productivity/terminal-shell-cli/cli-tooling-frameworks/cli-tooling/shell-productivity-enhancements/terminal-workflow-automations.md) — Provides a security layer for command-line tools to prevent unauthorized actions during automated execution.
- [Command Interception Hooks](https://awesome-repositories.com/f/development-tools-productivity/terminal-shell-cli/terminal-cli-enhancements/shell-terminal-utilities/automation-integration-tools/shell-integration/command-interception-hooks.md) — Intercepts and validates tool execution requests before they reach the system shell.
- [Command Line Automation Tools](https://awesome-repositories.com/f/development-tools-productivity/command-line-automation-tools.md) — Streamlines terminal tasks by automating permissions and injecting metadata into command environments.
- [Task Automation Tools](https://awesome-repositories.com/f/development-tools-productivity/task-automation-tools.md) — Automates tool permissions to bypass manual confirmation prompts during routine operations. ([source](https://github.com/charmbracelet/crush/tree/main/docs/hooks))
- [Process Execution Wrappers](https://awesome-repositories.com/f/development-tools-productivity/text-wrapping-utilities/process-execution-wrappers.md) — Wraps external tool calls in a controlled execution layer to monitor and manipulate command inputs and outputs.

### Software Engineering & Architecture

- [Policy-Driven Execution Guardrails](https://awesome-repositories.com/f/software-engineering-architecture/policy-driven-execution-guardrails.md) — Implements policy-driven security rules to automate approval workflows for tool execution.
- [Environment Variable Managers](https://awesome-repositories.com/f/software-engineering-architecture/application-lifecycle-management/configuration-management/environment-variable-management/environment-variable-managers.md) — Injects contextual metadata into the execution environment to guide agent behavior during tool invocations.