Platform

Plugins: adding tools and lifecycle hooks

Updated 2 min read

Atlas plugins extend the agent in 2 ways. They contribute tools, new capabilities the model can call alongside the built-in ones, and they hook into lifecycle events, running your code at defined points as a session proceeds. Together that covers both what the agent can do and what happens around it, without modifying Atlas itself.

Two extension points, not one

Most tools offer 1 extension point and force everything through it. Atlas separates contributing a tool, which changes what the agent is able to do, from hooking a lifecycle event, which changes what happens around what it does.

The split matters because the two have different shapes. Adding a deployment command is a tool: the model decides when to call it. Recording every session to an internal audit system is a hook: nobody wants the model deciding whether auditing happens. Collapsing both into one mechanism means one of them ends up modeled badly.

Plugin tools are still permission-gated

A tool contributed by a plugin passes through the same allow, ask, or deny check as the 1st-party ones. Installing a plugin does not create a path around the permission system, and unmatched actions still default to ask.

This is what makes third-party extension safe to adopt. The safety properties of Atlas are enforced at the tool-call boundary rather than inside each tool, so they apply uniformly to code the Atlas team did not write. A plugin can add capability; it cannot quietly add authority.

Plugins or MCP servers

The 2 mechanisms answer different questions. Write a plugin when you want to change how Atlas itself behaves. Use a Model Context Protocol server when you want to connect Atlas to a system that already exists and may serve other clients too.

MCP is the better choice for anything with an existing API surface, because the server you write is reusable beyond Atlas. Plugins are the better choice for behavior that is specific to how your team runs the agent, since that logic has no meaning outside the tool it customizes.

Frequently asked questions

Can I extend Atlas with my own tools?
Yes. Atlas plugins contribute tools the agent can call and hook into agent lifecycle events.
Are plugin tools subject to permissions?
Yes. A plugin-contributed tool passes the same allow, ask, or deny check as a built-in tool.
What is the difference between a plugin and an MCP server?
A plugin changes how Atlas itself behaves. An MCP server connects Atlas to an existing system and is reusable by other MCP clients.
Can a plugin run code during a session?
Yes. Lifecycle hooks let a plugin run at defined points as a session proceeds, independently of what the model chooses to call.

Try Atlas in your terminal

The terminal-native AI coding agent. Free core, single binary.

Install Atlas

Related guides

Atlas with GPT-5.5 Pro: One Hard Question at a Time in 2026

GPT-5.5 Pro is OpenAI's April 2026 maximum-effort reasoning tier at $30 / $180 per Mtok on a 1,050,000 token window. Invoke it deliberately in Atlas, then switch back.

Atlas with Snowflake Cortex in 2026: Claude Opus 4.8 Inside Your Snowflake Boundary

Atlas with Snowflake Cortex in 2026: Claude Opus 4.8 and Claude Fable 5 at a 1,000,000 token context, governed by Snowflake RBAC and billed in Snowflake credits.

Atlas with Claude Opus 4.7 in 2026: 1M Context at $5 / $25 per Mtok

Claude Opus 4.7 drives Atlas with a 1M tokens (1,000,000) window, 128K max output, and $5 per Mtok input, $25 per Mtok output. Setup, tradeoffs, and when to move on.

Atlas with Amazon Nova Lite in 2026: 300K Context on Your AWS Bill

Amazon Nova Lite drives Atlas at $0.06 per Mtok input and $0.24 per Mtok output with a 300K token context, billed through IAM with no new vendor API key to manage.

Atlas with Claude Opus 4.6: Setup, Cost, and Tradeoffs in 2026

Claude Opus 4.6 gives Atlas a 1M token context at $5 per Mtok input, $25 per Mtok output. Setup steps, cost math, and when to pick a newer Opus instead.

Atlas with Google Vertex AI (gateway) in 2026: Gemini and Claude Under One GCP Project

Google Vertex AI (gateway) runs Atlas on Gemini 3.1 Pro at $2 / $12 per Mtok with a 1M context, plus Claude through Atlas's google-vertex-anthropic route.

Atlas for Scala in 2026

Atlas is a terminal-native AI coding agent for Scala in 2026. Run it in a project with a build.sbt, let it read your traits and implicits, and approve every diff.

Atlas for Dart in 2026

Adopt Atlas, the terminal-native AI coding agent, for Dart development in 2026. Enhance productivity with intelligent code search, refactoring, and robust safety features across your Dart projects.

Browse this resource hub