# Frontend Tools

> Let an agent run browser code in your Angular app with registerFrontendTool.

Frontend tools let an agent call code inside the user's browser.
[Add a renderer](/angular/generative-ui/tool-rendering) to the same registration
when the tool should show progress or a result in chat.

## Register a browser tool [#register-a-browser-tool]

Call `registerFrontendTool` from an Angular injection context. The live
Showcase example builds a typed tool config around a writable signal:

```typescript title="features/tools/tool-feature-model.ts"
/** Create the frontend tool that applies a requested CSS gradient. */
export function createBackgroundTool(
  background: WritableSignal<string>,
): FrontendToolConfig<BackgroundToolArgs> {
  return {
    name: "change_background",
    description: "Change the application background to a CSS gradient.",
    parameters: z.object({
      background: z.string().optional(),
      color: z.string().optional(),
    }),
    handler: async (args) => {
      const next = resolveGradient(args.background ?? args.color);
      background.set(next);
      return { background: next };
    },
  };
}
```

Register that config from a component or service with
`registerFrontendTool(createBackgroundTool(background))`. The registration is
removed when that injector is destroyed.

The schema advertises the input shape and supplies TypeScript inference.
Runtime arguments arrive as parsed JSON; validate inside the handler when the
action needs a hard trust boundary. The handler receives the calling agent,
the raw tool call, and an optional abort signal as its second argument.

## Next steps [#next-steps]

- [registerFrontendTool API](/reference/angular/functions/registerFrontendTool)
- [Tool Call Rendering](/angular/generative-ui/tool-rendering): show the tool's progress and result in chat.
