johnlindquist

Plugin Better Tools — Development skill for Claude Code

Development community

Better Tools is a Codex plugin that observes supported tool calls through a PreToolUse hook and turns that local corpus into practical tooling advice.

How to install Plugin Better Tools

This entry records only its repository, not the path inside it, so there is no exact command to give. Open johnlindquist/plugin-better-tools and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Plugin Better Tools does

Better Tools is a Codex plugin that observes supported tool calls through a `PreToolUse` hook and turns that local corpus into practical tooling advice.

Alternatives in Development

Supported Languages — 22.1k ★
Understand Anything — Claude Code skills that turn any codebase into an interactive knowledge graph you can explore, search, and ask 2.5k ★
Nexting — Remote control for Claude Code, Codex, Grok, and Cursor on Mac or PC 1.3k ★

README

Better Tools

Better Tools is a Codex plugin that observes supported tool calls through a `PreToolUse` hook and turns that local corpus into practical tooling advice.

The hook writes a capped daily JSONL spool under `$PLUGIN_DATA/events/` and malformed payloads under `$PLUGIN_DATA/errors/`. Raw JSONL is not intended to become model context. The hook updates `indexes/tool-index.json` automatically on each captured call, and `scripts/better_tools.py` can regenerate richer compact summaries on demand. Thousands of duplicate tool calls collapse into counts, fingerprints, normalized command patterns, and a few examples.

What It Bundles

plugins/plugin-better-tools/hooks/hooks.json: registers the PreToolUse hook.
plugins/plugin-better-tools/hooks/capture_pre_tool_use.js: low-risk capture hook that redacts common secret-like values, truncates large records, appends JSONL, and exits successfully without blocking tools.
plugins/plugin-better-tools/scripts/better_tools.py: local analyzer for doctor, index, summary, patterns, blindspots, agents-md, report, and export. The index command can regenerate the compact index if needed.
plugins/plugin-better-tools/skills/better-tools/SKILL.md: Codex skill for tool optimization, tool blindspot analysis, new tool proposals, and AGENTS.md guidance.

Install From GitHub

Make sure plugin hooks are enabled in `~/.codex/config.toml`:

[features]
hooks = true
plugins = true
plugin_hooks = true

Add this repo as a Codex plugin marketplace, then install the plugin:

codex plugin marketplace add johnlindquist/plugin-better-tools
codex plugin add plugin-better-tools@plugin-better-tools

Restart Codex after installing or updating the plugin. Open `/plugins` to confirm `plugin-better-tools` is installed and enabled, then open `/hooks` to review/trust the bundled `PreToolUse` hook if Codex asks for hook trust.