co-mono/packages/coding-agent/examples
Mario Zechner e4dd21a3b2 feat(hooks): add systemPromptAppend to before_agent_start, full tool registry
- before_agent_start handlers can return systemPromptAppend to dynamically
  append text to the system prompt for that turn
- Multiple hooks' systemPromptAppend strings are concatenated
- Multiple hooks' messages are now all injected (not just first)
- Tool registry now contains ALL built-in tools (read, bash, edit, write,
  grep, find, ls) regardless of --tools flag
- --tools only sets initially active tools, hooks can enable any via
  setActiveTools()
- System prompt automatically rebuilds when tools change, updating tool
  descriptions and guidelines
- Add pirate.ts example hook demonstrating systemPromptAppend
- Update hooks.md with systemPromptAppend documentation
2026-01-04 18:21:26 +01:00
..
custom-tools docs(coding-agent): correct filename in subagent example README (#427) 2026-01-03 22:36:58 +01:00
hooks feat(hooks): add systemPromptAppend to before_agent_start, full tool registry 2026-01-04 18:21:26 +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