A collection of practical tools, hooks, and utilities designed to enhance CLI coding agents like Claude Code. It provides terminal automation, natural language-to-shell command translation, robust safety guardrails, and integration with alternative LLMs, significantly boosting developer productivity and agent safety.

How It Works

The project offers several key utilities: tmux-cli acts as "Playwright for the terminal," enabling programmatic control over interactive CLI applications and debugging sessions via tmux. lmsh translates natural language into shell commands, allowing users to edit and execute them safely. A suite of safety hooks provides guardrails for bash, git, and file operations to prevent accidental data loss and security breaches, complemented by env-safe for secure .env file inspection. Additional tools include vault for encrypted .env backups and find-claude-session for managing agent sessions.

Quick Start & Requirements

• Primary install command: uv tool install claude-code-tools
• Key prerequisites: Python 3.11+, uv (for installation), tmux (for tmux-cli), SOPS (for vault).
• Relevant documentation links: docs/tmux-cli-instructions.md, docs/lmsh.md, docs/find-claude-session.md, docs/vault-documentation.md, hooks/README.md.

Highlighted Details

• tmux-cli: Enables AI agents to automate interactive terminal applications, functioning as "Playwright for the terminal."
• lmsh: Translates natural language to shell commands with an editable preview, offering rapid, safe command execution.
• Safety Hooks: Implements comprehensive guardrails for bash, git, and file operations, preventing common security risks and data loss.
• LLM Compatibility: Facilitates seamless integration with various open-weight LLMs (e.g., Kimi, Deepseek) via Anthropic-compatible APIs.

Maintenance & Community

The repository is hosted on GitHub (pchalasani/claude-code-tools). Development practices include version management via commitizen and standard contribution workflows. No specific community channels or contributor details are provided in the README.

Licensing & Compatibility

• License type: MIT.
• Compatibility: The MIT license is permissive, generally allowing for commercial use and integration with closed-source projects.

Limitations & Caveats

• lmsh is explicitly marked as experimental.
• tmux-cli requires tmux and vault requires SOPS to be installed.
• The safety hooks require manual configuration within ~/.claude/settings.json.
• While tmux-cli is noted to work with any CLI coding agent, the project's primary focus and examples center around enhancing "Claude Code."