workflow

claude-code-tools

A collection of practical tools, hooks, and utilities for enhancing Claude Code and other CLI coding agents.

🚀 Quick Start

uv tool install claude-code-tools   # Python package
cargo install aichat-search         # Rust search TUI (requires Rust)

Prerequisites:

• Node.js 16+ — Required for aichat action menus (resume, export, etc.)
• Rust/Cargo — Required for aichat search (install via cargo install)

Without aichat-search, the search command won't be available, but other aichat commands still work.

What You Get

Four commands are installed:

Command	Description
aichat	Session management for Claude Code and Codex (find, resume, export, trim, query)
tmux-cli	Terminal automation for AI agents ("Playwright for terminals")
vault	Encrypted .env backup and sync
env-safe	Safe .env inspection without exposing values

---

⚠️ Breaking Change (v1.0)

All session tools are now under aichat. Use aichat search instead of find-claude-session/find-codex-session, and similarly for other commands.

---

Table of Contents

• 🚀 Quick Start
• 🎮 tmux-cli — Terminal Automation
• 💬 aichat — Session Management
• 🚀 lmsh (Experimental) — natural language shell
• 🔐 Utilities
• 🛡️ Claude Code Safety Hooks
• 🤖 Using with Alternative LLM Providers
• 📚 Documentation
• 📋 Requirements
• 🛠️ Development
• 📄 License

🎮 tmux-cli — Terminal Automation

Note: While the description below focuses on Claude Code, tmux-cli works with any CLI coding agent.

Think Playwright for terminals - Terminal automation for AI agents.

tmux-cli enables Claude Code to programmatically control terminal applications: test interactive scripts, debug with pdb, launch and interact with other CLI agents.

Important: You don't need to learn tmux-cli commands. Claude Code handles everything automatically—just describe what you want.

Works anywhere: Automatically handles both local tmux panes and remote sessions.

🎮 tmux-cli Deep Dive

What Claude Code Can Do With tmux-cli

1. Test Interactive Scripts - CC can run and interact with scripts that require user input, answering prompts automatically based on your instructions.

2. UI Development & Testing - CC can launch web servers and coordinate with browser automation tools to test your applications.

3. Interactive Debugging - CC can use debuggers (pdb, node inspect, gdb) to step through code, examine variables, and help you understand program flow.

4. Claude-to-Claude Communication - CC can launch another Claude Code instance to get specialized help or code reviews.

Claude Code knows how to use tmux-cli through its built-in help. You just describe what you want, and CC handles the technical details.

For complete command reference, see docs/tmux-cli-instructions.md.

Setting up tmux-cli for Claude Code

To enable CC to use tmux-cli, add this snippet to your global ~/.claude/CLAUDE.md file:

# tmux-cli Command to interact with CLI applications

`tmux-cli` is a bash command that enables Claude Code to control CLI applications 
running in separate tmux panes - launch programs, send input, capture output, 
and manage interactive sessions. Run `tmux-cli --help` for detailed usage 
instructions.

Example uses:
- Interact with a script that waits for user input
- Launch another Claude Code instance to have it perform some analysis or review or 
  debugging etc
- Run a Python script with the Pdb debugger to step thru its execution, for 
  code-understanding and debugging
- Launch web apps and test them with browser automation MCP tools like Playwright or 
Chrome Dev Tools.

More frequently, I use this method: I launch another CLI-agent (say Codex-CLI) in another tmux pane, and say something like this to the first agent:

There's another coding agent "Codex" running in tmux Pane 3. Feel free to use Codex to help you with your task or review your work. You can communicate with Codex using the tmux-cli command; you can do tmu-cli --help to see how to use it.

For detailed instructions, see docs/tmux-cli-instructions.md.

All of this assumes you're familiar and comfortable with tmux, and (like me) run all CLI coding sessions inside tmux sessions.