# client-tools

client-tools configures webhook and client-side actions for conversational voice agents, connecting them to external APIs and browser scripts.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 78316 repo stars
- Author: calesthio
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/calesthio/OpenMontage/tree/HEAD/.agents/skills/agents/references/client-tools.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/client-tools

## What it does

The subagent guides the setup of external capabilities within a voice agent prompt configuration. It organizes actions into server webhooks, browser-side client scripts, and built-in system routines. Custom tools live under `conversation_config.agent.prompt.tools`, while native actions like call termination stay in `built_in_tools`.

Webhook definitions configure endpoints, timeouts from 5 to 120 seconds, and payload validation schemas. The default HTTP verb is `GET`. Any endpoint expecting request bodies requires `POST` explicitly. The configuration supports workspace environment variables for hosts and secrets, along with OAuth2, Bearer tokens, or custom headers.

Backend endpoints in Python or Node.js receive incoming tool calls containing parameters and a conversation identifier. They return raw strings or structured JSON back to the agent.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/client-tools.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/client-tools.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/client-tools.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/calesthio/OpenMontage/tree/HEAD/.agents/skills/agents/references/client-tools.md

## When to use it
- configure webhook endpoints with authentication schemas and timeouts
- supply conversation history using dynamic template variables
- connect conversational voice agents to browser-side interface actions
- scaffold webhook handler endpoints in Python or Node.js

## Example prompts
- Configure a `get_weather` webhook tool using `POST` with bearer authentication
- Add a browser-side client action to `conversation_config` for UI updates
- Write an Express route handling the incoming payload for `lookup_order`

## Similar
- [elevenlabs-agents](https://affpapa.org/en/nevibecode/skills/elevenlabs-agents.md) — skill · 1700 installs
- [integrate-whatsapp-calling](https://affpapa.org/en/nevibecode/skills/integrate-whatsapp-calling.md) — skill · 996 installs
- [ElevenLabs Agents](https://affpapa.org/en/nevibecode/mcp/elevenlabs-agents.md) — MCP server · ★ 14 repo stars
- [elevenlabs-webhooks](https://affpapa.org/en/nevibecode/skills/elevenlabs-webhooks.md) — skill · 237 installs
- [create-assistant](https://affpapa.org/en/nevibecode/skills/create-assistant.md) — skill · 1100 installs
- [create-squad](https://affpapa.org/en/nevibecode/skills/create-squad.md) — skill · 910 installs

From the same set: [calesthio/openmontage](https://affpapa.org/en/nevibecode/by/calesthio/openmontage.md) — 101 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
