Files
oh-my-pi/packages/coding-agent/examples/hooks
can1357 cc90ed37f8 refactor: extracted padding logic into reusable utility function with optimized buffer allocation
- Extracted manual space padding logic into a reusable `padding()` utility function across all UI components and utilities.
- Optimized padding operations by introducing a pre-allocated 512-space buffer in the `padding()` function to reduce repeated string allocations.
- Updated all imports across 30 files to use the new `padding()` function from pi-tui instead of inline `' '.repeat()` calls.
- Renamed local variables from `padding` to `pad`, `padSize`, `indent`, or `linePad` to avoid naming conflicts with the imported `padding()` function.
- Exported the `padding()` utility function from the tui package index for public use.
2026-01-31 13:36:54 +01:00
..

Hooks Examples

Example hooks for omp-coding-agent.

Usage

# Load a hook with --hook flag
omp --hook examples/hooks/permission-gate.ts

# Or copy to hooks directory for auto-discovery
cp permission-gate.ts ~/.omp/agent/hooks/

Examples

Hook Description
permission-gate.ts Prompts for confirmation before dangerous bash commands (rm -rf, sudo, etc.)
git-checkpoint.ts Creates git stash checkpoints at each turn for code restoration on branch
protected-paths.ts Blocks writes to protected paths (.env, .git/, node_modules/)
file-trigger.ts Watches a trigger file and injects contents into conversation
confirm-destructive.ts Confirms before destructive session actions (clear, switch, branch)
dirty-repo-guard.ts Prevents session changes with uncommitted git changes
auto-commit-on-exit.ts Auto-commits on exit using last assistant message for commit message
custom-compaction.ts Custom compaction that summarizes entire conversation
qna.ts Extracts questions from last response into editor via ctx.ui.setEditorText()
snake.ts Snake game with custom UI, keyboard handling, and session persistence
status-line.ts Shows turn progress in footer via ctx.ui.setStatus() with themed colors
handoff.ts Transfer context to a new focused session via /handoff <goal>

Writing Hooks

See docs/hooks.md for full documentation.

import type { HookAPI } from "@oh-my-pi/pi-coding-agent/hooks";

export default function (pi: HookAPI) {
	// Subscribe to events
	pi.on("tool_call", async (event, ctx) => {
		if (event.toolName === "bash" && event.input.command?.includes("rm -rf")) {
			const ok = await ctx.ui.confirm("Dangerous!", "Allow rm -rf?");
			if (!ok) return { block: true, reason: "Blocked by user" };
		}
	});

	// Register custom commands
	pi.registerCommand("hello", {
		description: "Say hello",
		handler: async (args, ctx) => {
			ctx.ui.notify("Hello!", "info");
		},
	});
}