claude-code-tools 1.17.0

Collection of tools for working with Claude Code

CLI tools, skills, agents, hooks, and plugins for enhancing productivity with Claude Code and other coding agents.

Full Documentation

Install

# Core package
uv tool install claude-code-tools

# With Google Docs/Sheets extras
uv tool install "claude-code-tools[gdocs]"

# Upgrade an existing installation
uv tool install --force claude-code-tools

The search engine (aichat search) requires a separate Rust binary:

• Homebrew (macOS/Linux): brew install pchalasani/tap/aichat-search
• Cargo: cargo install aichat-search
• Pre-built binary: Releases (look for rust-v*)

Install the Claude Code workflow plugin:

claude plugin marketplace add pchalasani/claude-code-tools
claude plugin install workflow@cctools-plugins

Install the equivalent dynamic workflow plugin for Codex:

codex plugin marketplace add pchalasani/claude-code-tools
codex plugin add dynamic-workflow@cctools-codex-plugins

The Codex plugin installs independently: it does not require the Python claude-code-tools package or an npm install. Node.js 20 or newer and Codex CLI 0.136.0 or newer are required for callbacks. Version 0.136.0 is the first compatible CLI release for this callback protocol. Codex still marks the app server and remote TUI interfaces as experimental, so those surfaces may evolve. The plugin can notify the originating Codex thread through Codex's shared app server after a detached workflow finishes. Callback preflight also rejects a stale connected server.

The optional Python package makes that callback setup a single command:

codex-dynamic
# Or continue the latest conversation:
codex-dynamic resume --last

codex-dynamic starts or reuses the local app server and then hands the terminal directly to Codex. After a plugin or Codex upgrade, the next launch automatically starts a fresh server generation; existing sessions and workflow callbacks stay connected to their old generation. No manual restart is needed. Use codex-server status or logs for nondisruptive inspection. A forced stop or restart cleans up every retained generation and disconnects its attached TUIs, so use those commands only after exiting the sessions normally.

The Python package also installs codex-workflows, an observational dashboard for durable workflow runs:

codex-workflows
codex-workflows watch --limit 20
codex-workflows show RUN_ID
codex-workflows --all

The default list contains only active workflows and identifies the project folder from which each workflow was launched. Use show RUN_ID for its full working directory, or --all to include completed and diagnostic history. The command reads durable workflow state and process metadata. It never changes a run, sends a signal, repairs state, or launches an agent. See the codex-workflows reference for filters, JSON output, and the complete versioned schema.

Server management and passive supervision add no model calls. Completion reporting starts a new turn only while the thread is idle; otherwise it steers and extends the active turn. Either reporting path consumes model tokens.

Each workflow run or resume uses narrow host execution for that exact reviewed supervisor command. The workflow JavaScript remains restricted, and every headless Codex worker keeps its declared sandbox.

See the Claude → Codex migration guide for usage and workflow-porting instructions.

---

Click a card to jump to that feature, or read the full docs.

---

Legacy links — The sections below exist to preserve links shared in earlier discussions. For current documentation, visit the full docs site.

aichat — Session Management

See aichat in the full documentation.

tmux-cli — Terminal Automation

See tmux-cli in the full documentation.

Voice Plugin

See Voice in the full documentation.

License

MIT