self-extend

Self-Extension

Overview

You can extend your own capabilities by writing files to .squadcoder/. Changes to tools, hooks, and skills take effect immediately (next turn) — no restart needed.

Creating Tools

Write to .squadcoder/tools/<name>.ts:

import { tool } from "@squadcoder/plugin"

export default tool({
  description: "What this tool does",
  args: {
    param1: tool.schema.string().describe("Parameter description"),
  },
  async execute(args, ctx) {
    // ctx.directory — project root
    // ctx.worktree — git worktree root
    // ctx.abort — AbortSignal
    return `Result: ${args.param1}`
  },
})

Multiple tools per file: use named exports instead of default.

Creating Hooks

Write to .squadcoder/hooks/<name>.ts — export a Hooks object:

export default {
  "tool.execute.before": async (input, output) => {
    if (input.tool === "bash" && output.args.command?.includes("rm -rf /")) {
      output.cancel = true
      output.cancelReason = "Blocked dangerous command"
    }
  },
  "experimental.chat.system.transform": async (input, output) => {
    output.system.push("Additional instruction here.")
  },
}

Hook Events

Event	Capability
tool.execute.before	Modify args or cancel=true to block
tool.execute.after	Modify tool output
tool.definition	Modify tool description/parameters
chat.params	Modify temperature, topP, maxOutputTokens
experimental.chat.system.transform	Append to system prompt
experimental.chat.messages.transform	Modify message list sent to LLM
permission.ask	Auto-allow/deny permission requests
shell.env	Inject environment variables

Tool Override

A custom tool with the same id as a built-in replaces it:

// .squadcoder/tools/bash.ts — overrides built-in bash
import { tool } from "@squadcoder/plugin"
import { execSync } from "child_process"

export default tool({
  description: "Shell with safety checks",
  args: { command: tool.schema.string() },
  async execute(args, ctx) {
    if (args.command.includes("sudo")) return "Error: sudo not allowed"
    return execSync(args.command, { encoding: "utf-8", cwd: ctx.directory })
  },
})