co-mono/packages/coding-agent/examples
Helmut Januschka 059292ead1 WIP: Add hook API for dynamic tool control with plan-mode hook example
- Add pi.getTools() and pi.setTools(toolNames) to HookAPI
- Hooks can now enable/disable tools dynamically
- Changes take effect on next agent turn

New example hook: plan-mode.ts
- Claude Code-style read-only exploration mode
- /plan command toggles plan mode on/off
- Plan mode tools: read, bash, grep, find, ls
- Edit/write tools disabled in plan mode
- Injects context telling agent about restrictions
- After each response, prompts to execute/stay/refine
- State persists across sessions
2026-01-04 18:13:28 +01:00
..
custom-tools docs(coding-agent): correct filename in subagent example README (#427) 2026-01-03 22:36:58 +01:00
hooks WIP: Add hook API for dynamic tool control with plan-mode hook example 2026-01-04 18:13:28 +01:00
sdk Add setEditorText/getEditorText to hook UI context, improve custom() API 2026-01-01 00:04:56 +01:00
README.md Add todo hook companion to todo custom tool 2026-01-03 00:13:25 +01:00

Examples

Example code for pi-coding-agent SDK, hooks, and custom tools.

Directories

sdk/

Programmatic usage via createAgentSession(). Shows how to customize models, prompts, tools, hooks, and session management.

hooks/

Example hooks for intercepting tool calls, adding safety gates, and integrating with external systems.

custom-tools/

Example custom tools that extend the agent's capabilities.

Tool + Hook Combinations

Some examples are designed to work together:

  • todo/ - The custom tool lets the LLM manage a todo list, while the hook adds a /todos command for users to view todos at any time.

Documentation