Extend it

Plugins & hooks

Plugins extend FreeCoder, and hooks let your own scripts fire on agent events — when a file is edited, before or after a tool runs, at session start, and more. It's how you wrap guardrails, formatting, and automation around the agent so it always follows your standards.

What you can do with hooks

  • Format and lint automatically after every edit.
  • Block risky actions with a pre-tool guard.
  • Notify a channel when a long job finishes.
  • Inject context at session start — environment, branch, ticket details.

Managing plugins

freecoder plugin

Use the plugin command to list and manage what's installed. A single plugin can ship hooks, commands, and integrations, so it can teach FreeCoder an entire workflow at once.

Hooks + skills + MCP

The three extension points compose: skills give the agent know-how, hooks automate around its actions, and MCP servers connect external systems. Together they turn FreeCoder from a great default into your agent.

Hooks run locally and deterministically — perfect for enforcing standards the model should never skip.