Plugins

This repo ships skills (instructions a coding agent follows) and plugins (skills bundled with hooks or agents). Most of what people want is a skill, and skills install with one command. Most work in Claude Code, Codex, Cursor, Gemini CLI, and some twenty other agents; a few are Claude Code and Codex only, as the table below notes.

Install a skill (any agent)

The skills CLI runs through npx, so it needs Node.js 22.20 or newer.

npx skills add pchalasani/claude-code-tools -s voxtype-install   # one skill
npx skills add pchalasani/claude-code-tools                      # choose from all

Add -g to install for every project instead of just the current one. The skills CLI puts the skill in .agents/skills/ (read by Codex and most agents) and symlinks it into .claude/skills/ for Claude Code; nothing else from this repo comes along. Then just ask your agent, e.g. “install voxtype and set it up”.

Skills available this way. Some drive a command-line tool that npx skills add does not install; the last column says what to install alongside the skill:

Skill	What it does	Also install
`voxtype-install`	Install and configure voxtype voice dictation	nothing (it installs voxtype)
`agent-style`	Formal prose rules (writing)	nothing (optional: `uv tool install agent-style` for a deterministic audit)
`remove-ai-patterns`	De-AI casual prose (writing)	Node.js
`jev-prose`	Jev prose checks (writing)	`uv tool install ./packages/jev-prose` from a checkout of this repo
`patterns`, `add-pattern`	Langroid design patterns (langroid)	nothing
`log-work`, `make-issue-spec`, `socratic-quiz`	Workflow helpers (workflow)	nothing
`code-walk-thru`	Walk through code in your editor (workflow)	your editor’s CLI (`code`, `zed`, `nvim`, …)
`tmux-cli`	Drive other CLI agents and scripts in tmux panes	`tmux`, `uv tool install claude-code-tools`
`session-search`	Past-session search for agents without sub-agents (e.g. Codex)	`uv tool install claude-code-tools`, `cargo install aichat-search`, `jq`
`msg`	Inter-agent messaging, Claude Code and Codex only (the plugin adds notification hooks)	`tmux`, `uv tool install claude-code-tools`
`github-wake`	Wake a Claude Code or Codex session on a GitHub reply	`uv tool install claude-code-tools`, an authenticated `gh`
`visual-brief`	Structured local HTML progress briefs, Claude Code and Codex only (visual-brief)	`uv tool install visual-brief` (plus `claude-code-tools` for Codex replies via `codex-dynamic`)

Plugins with hooks or agents

A few plugins also carry hooks (code that runs on tool calls or when a turn ends) or agents, which the skills CLI cannot install. Those use the agent’s own plugin marketplace, below: safety-hooks, agent-tunnel, msg, visual-brief, voice, workflow, and aichat. Their skills still install with npx skills add; the marketplace adds the hook half. Two skills need their plugin outright because they run files bundled with it: dynamic-workflow (its workflow runner) and voice-update (its say script). A third, recover-context, needs the aichat plugin in Claude Code, where it calls that plugin’s session-searcher agent; in Codex it falls back to the session-search skill.

Plugin Overview

Plugin	Description
`visual-brief`	Optional milestone reminders for Visual Brief
`aichat`	Hooks, commands, skills, agents for session work and search
`tmux-cli`	Terminal automation skill
`workflow`	Work logging, code walk-through, issue specs, UI testing
`safety-hooks`	Prevent destructive operations
`langroid`	Design patterns for the Langroid framework
`voice`	Spoken audio summaries
`agent-tunnel`	`>share` a live session so teammates can ask it questions over Discord or Mattermost
`dynamic-workflow`	Durable JavaScript orchestration for headless Codex agents
`writing`	Prose-quality skills: agent-style rules and remove-ai-patterns de-AI-ing

Codex plugin marketplace

This repo also hosts a Codex marketplace (cctools-codex-plugins, read from .agents/plugins/marketplace.json), currently offering the visual-brief, dynamic-workflow, voxtype, and writing plugins. Add it once, then install with codex plugin add:

codex plugin marketplace add pchalasani/claude-code-tools
codex plugin marketplace upgrade cctools-codex-plugins  # refresh if already added
codex plugin add visual-brief@cctools-codex-plugins
codex plugin add dynamic-workflow@cctools-codex-plugins
codex plugin add writing@cctools-codex-plugins

Visual Brief requires its separate CLI, installed with uv tool install visual-brief. Its optional plugin adds quiet, session-scoped reminders after a successful briefing publish. See the Visual Brief reference for the local browser behavior and setup.

dynamic-workflow

The plugin itself does not require uv tool install claude-code-tools or an npm install. It includes the skill and compiled runner; Node.js 20 or newer only needs to be available to execute the runner. For completion callbacks, the optional codex-dynamic helper starts Codex through its shared app server with one command. The manual setup remains available, and neither path requires MCP. Codex still marks the underlying app-server and remote TUI interfaces as experimental, so their CLI and protocol surfaces may evolve.

If a codex-dynamic app server is already running during an install or update, start Codex normally afterward. The helper automatically selects a fresh server generation while existing TUIs and callbacks remain connected to their original generation.

See the Dynamic Workflow detail page for its JavaScript API, state model, and safety boundaries.

Claude Code plugin marketplace

Add the marketplace

From your terminal:
Terminal window
```
claude plugin marketplace add pchalasani/claude-code-tools
```
Or from inside a Claude Code session:
```
/plugin marketplace add pchalasani/claude-code-tools
```
This creates the cctools-plugins plugin group.

Install plugins

claude plugin install "visual-brief@cctools-plugins"
claude plugin install "aichat@cctools-plugins"
claude plugin install "tmux-cli@cctools-plugins"
claude plugin install "workflow@cctools-plugins"
claude plugin install "safety-hooks@cctools-plugins"
claude plugin install "langroid@cctools-plugins"
claude plugin install "voice@cctools-plugins"
claude plugin install "agent-tunnel@cctools-plugins"
claude plugin install "writing@cctools-plugins"

Or use /plugin without arguments inside a session to launch a TUI for browsing and installing.

Visual Brief Plugin

Visual Brief turns substantial Claude Code or Codex updates into concise local browser briefings. Install the visual-brief CLI separately, then optionally install this plugin for quiet milestone reminders. See the Visual Brief reference for the complete setup and workflow.

aichat Plugin

The aichat plugin provides hooks, skills, and an agent for session management and search.

Type	Name	What it does
Hook	`>resume`	Type `>resume` (or `>continue`, `>handoff`) to copy session ID and show resume instructions
Hook	`>session`	Type `>session` (or `>session-id`) to copy the session ID to clipboard
Hook	`>trim`	Preview an in-place trim of the current session, then `>trim yes` to apply / `>trim help` for options (savings kick in on the next resume)
Skill	`/session-search`	Search past sessions (for agents without sub-agent support, e.g. Codex)
Skill	`/recover-context`	Extract context from parent sessions into the current conversation
Agent	`session-searcher`	Sub-agent to search and retrieve context from past sessions

tmux-cli Plugin

Type	Name	What it does
Skill	`/tmux-cli`	Interact with CLI apps and agents in other tmux panes

The skill gives Claude Code the ability to send commands, read output, and coordinate with processes (including other CLI agents) running in other tmux panes. See the tmux-cli tool page for full details.

safety-hooks Plugin

Hooks that block or require approval for dangerous operations.

Hook	What it blocks / modifies
`rm` protection	Blocks `rm -rf` on critical paths; requires approval for others
`git add` protection	Blocks bulk staging (`git add -A`, `git add .`, wildcards)
`git checkout` protection	Warns before discarding uncommitted changes
`git commit` protection	Asks before commits; `CCTOOLS_ALLOW_GIT=1` allows them
`.env` protection	Blocks all read/write/edit of `.env` files; suggests `env-safe` CLI
File length limit	Blocks reading files >500 lines to prevent context bloat

See the Safety Hooks detail page for hook file descriptions and full documentation.

workflow Plugin

Skills and agents for development workflow tasks.

Skill / Agent	What it does
`/code-walk-thru`	Walk through files in your editor to explain code or show changes
`/log-work`	Log work progress to `WORKLOG/YYYYMMDD.md`
`/make-issue-spec`	Create task specs at `issues/YYYYMMDD-topic.md`
`ui-tester` agent	Browser-based UI testing via Chrome DevTools MCP

See the Workflow detail page for more information.

langroid Plugin

Design pattern knowledge for the Langroid multi-agent LLM framework.

Skill	What it does
`/patterns`	Index of Langroid design patterns (agent config, tools, task control, MCP integration)
`/add-pattern`	Record new patterns as you learn them from the Langroid codebase

See the Langroid detail page for more information.

voice Plugin

Get spoken audio feedback when Claude Code completes a task. The agent automatically speaks a 1-2 sentence summary before stopping, so you can multitask while Claude works.

Uses pocket-tts for lightweight text-to-speech.

See the Voice detail page for prerequisites, configuration, architecture details, and recommended speech-to-text companions.

agent-tunnel Plugin

Publishes the current Claude Code session so teammates can ask it questions over Discord or Mattermost — each answered against a private, read-only fork.

Type	Name	What it does
Hook	`>share`	Publish this session and mint a handle to hand to colleagues (`>share <label>`, `>share --write`, `>share --dangerously-allow-bash`, `>share status`, `>share off`)

This plugin provides only the >share hook. The daemon that answers the questions — agent-tunnel serve and the rest of the CLI — ships with the claude-code-tools package (uv tool install claude-code-tools). See the agent-tunnel tool page for the full setup: creating the Discord or Mattermost bot, configuration, and running the daemon.

writing Plugin

Three prose-quality skills, including Jev feedback during writing. The original two skills remain explicit-trigger only. Works in both Claude Code (writing@cctools-plugins) and Codex (writing@cctools-codex-plugins).

Skill	What it does
`/agent-style`	21 literature-backed rules for formal technical prose (papers, design docs, READMEs)
`/remove-ai-patterns`	Remove AI-writing patterns at any register, with voice profiles and a deterministic Node.js detector
`/jev-prose`	Jev pattern checks and up to three guided revisions

The original two skills vendor a pinned snapshot of their upstream source (agent-style, CC BY 4.0, and avoid-ai-writing, MIT), so they work offline. Jev checks need the separate jev-prose CLI and a configured backend; see the detail page below.

See the Writing detail page for installation in both agents, the skills’ scope, the detector workflow, and how the vendored upstream snapshots are updated.