Oct 1, 2025 · Oct 1, 2025 · Oct 1, 2025 · Oct 1, 2025 · Oct 1, 2025 · Oct 1, 2025
diff --git a/docs/ai-coder/agent-boundary.md b/docs/ai-coder/agent-boundary.md
 # Agent Boundary

 Agent Boundaries are process-level firewalls that restrict and audit what autonomous programs, such as AI agents, can access and use.

 ![Screenshot of Agent Boundaries blocking a process](../images/guides/ai-agents/boundary.png)Example of Agent Boundaries blocking a process.

 The easiest way to use Agent Boundaries is through existing Coder modules, such as the [Claude Code module](https://registry.coder.com/modules/coder/claude-code). It can also be ran directly in the terminal by installing the [CLI](https://github.com/coder/boundary).

 > [!NOTE]
 > The Coder Boundary CLI is free and open source. Integrations with the core product, such as with modules offering stronger isolation, are available to Coder Premium customers.

 ## Supported Agents

 Boundary supports the securing of any terminal-based agent, including your own custom agents.

 ## Features

 Boundaries extend Coder's trusted workspaces with a defense-in-depth model that detects and prevents destructive actions without reducing productivity by slowing down workflows or blocking automation. They offer the following features:

 - _Policy-driven access controls_: limit what an agent can access (repos, registries, APIs, files, commands)
 - _Network policy enforcement_: block domains, subnets, or HTTP verbs to prevent exfiltration
 - _Audit-ready_: centralize logs, exportable for compliance, with full visibility into agent actions

 ## Getting Started with Boundary

 For Early Access, users can use Agent Boundaries through its [open source CLI](https://github.com/coder/boundary), which can be run to wrap any process or invoked through rules in a YAML file.


 ### Wrap the agent process with the Boundary CLI

 Users can also run Boundary directly in your workspace and configure it per template or per script. While free tier users won't get centralized policy management or the deeper, "strong isolation," they can still enforce per workspace network rules and log decisions locally.


 1. Install the [binary](https://github.com/coder/boundary) into the workspace image or at start-up. You can do so with the following command:

    ```hcl
    curl -fsSL https://raw.githubusercontent.com/coder/boundary/main/install.sh | bash
    ```

 1. Use the included `Makefile` to build your project. Here are a few example commands:

    ```hcl
    make build          # Build for current platform
    make build-all      # Build for all platforms
    make test           # Run tests
    make test-coverage  # Run tests with coverage
    make clean          # Clean build artifacts
    make fmt            # Format code
    make lint           # Lint code
    ```

 From here, there are two ways to integrate the open source Boundary CLI into a workspace.

 #### Wrap a command inline with flags
 1. Wrap the tool you want to guard. Below are some examples of usage:

    ```hcl
    # Allow only requests to github.com
    boundary --allow "github.com" -- curl https://github.com

    # Allow full access to GitHub issues API, but only GET/HEAD elsewhere on GitHub
    boundary \
    --allow "github.com/api/issues/*" \
    --allow "GET,HEAD github.com" \
    -- npm install

    # Default deny-all: everything is blocked unless explicitly allowed
    boundary -- curl https://example.com
    ```

    Additional information, such as Allow Rules, can be found in the [repository README](https://github.com/coder/boundary).

 #### Use a config file (YAML) to set rules

 Another option is to define rules in a YAML file, which only needs to be invoked once as opposed to through flags with each command.
 1. Create a YAML file to store rules that will be applied to all `boundary` commands run in the Workspace. In this example, we call it `boundary.yaml`.

    A config example can be seen below:

    ```hcl
    allow:

    - domain: [github.com](http://github.com)

        path: /api/issues/*

    - domain: [github.com](http://github.com)

        methods: [GET, HEAD]
    ```
 1. Run a `boundary` command. For example:

    ```hcl
    boundary run --config ./boundary.yaml -- claude
    ```

    You will notice that the rules are automatically applied without any need for additional customization.

 ### Unprivileged vs. Privileged Mode

 There are two approaches you can take to secure your agentic workflows with Agent Boundary.

 #### Unprivileged Mode

 In this case, a specific agent process or tool (for example, Claude Code or a CLI agent) runs inside of a constrained sandbox. This is the default mode in which Boundary will operate in and does not require root access.

 Agents are prevented from reaching restricted domains or exfiltrating data, without blocking the rest of the dev's environment.

 This is the fastest way to add real guardrails, but a determined user could still operate a tool outside of Boundary restrictions because the broader environment allows it. This mode relies on tools respecting certain settings, like HTTP proxies, and can lead to silent failures if a tool bypasses them.

 #### Privileged Mode

 In this case, boundaries are enforced at the level of the environment that the agent lives in. These are workspace- or session-level controls, including how the developer connects to it.

 Currently, this must be turned on with a flag and ran with higher-level permissions such as root access or `CapNetAdmin`.

 In addition to process-level egress rules, privileged mode locks down all pathways that could bypass policy, such as restricting or disabling SSH tunnels or parallel unbound IDEs. This delivers deterministic, policy-as-code enforcement and offers the highest assurance for regulated environments, but results in slightly more friction for mixed human-and-agent workflows.

 ### Opting out of Boundary

 If you tried Boundary through a Coder module and decided you don't want to use it, you can turn it off by setting the flag to `boundary_enabled=false`.
diff --git a/docs/ai-coder/index.md b/docs/ai-coder/index.md

 ![Coder Tasks UI](../images/guides/ai-agents/tasks-ui.png)

 [Learn more about Coder Tasks](./tasks.md) to how to get started and best practices.
 [Learn more about Coder Tasks](./tasks.md) for best practices and how to get started.

 ## Secure Your Workflows with Agent Boundaries (Beta)

 AI agents can be powerful teammates, but must be treated as untrusted and unpredictable interns as opposed to tools. Without the right controls, they can go rogue.

 [Agent Boundaries](./agent-boundary.md) is a new tool that offers process-level safeguards that detect and prevent destructive actions. Unlike traditional mitigation methods like firewalls, service meshes, and RBAC systems, Agent Boundaries is an agent-aware, centralized control point that can either be embedded in the same secure Coder Workspaces that enterprises already trust, or used through an open source CLI.

 To learn more about features, implementation details, and how to get started, check out the [Agent Boundary documentation](./agent-boundary.md).
diff --git a/docs/ai-coder/security.md b/docs/ai-coder/security.md

 Many agents require API keys to access external services. It is recommended to
 create a separate API key for your agent with the minimum permissions required.
 This will likely involve editing your template for Agents to set different scopes or tokens
 from the standard one.
 This will likely involve editing your template for Agents to set different scopes or tokens from the standard one.

 Additional guidance and tooling is coming in future releases of Coder.

 ## Set Up Agent Boundaries(Premium)
 ## Set Up Agent Boundaries

 Agent Boundaries add an additional layer and isolation of security between the
 agent and the rest of the environment inside of your Coder workspace, allowing
 humans to have more privileges and access compared to agents inside the same
 workspace.

 - [Contact us for more information](https://coder.com/contact) and for early access to agent boundaries
 Agent Boundaries are process-level "agent firewalls" that lets you restrict and audit what AI agents can access within Coder workspaces. To learn more about this feature, see [Agent Boundary](./agent-boundary.md).
diff --git a/docs/images/guides/ai-agents/boundary.png b/docs/images/guides/ai-agents/boundary.png
diff --git a/docs/manifest.json b/docs/manifest.json
 "description":"Connect to agents Coder with a MCP server",
 "path":"./ai-coder/mcp-server.md",
 "state": ["beta"]
 },
 {
 "title":"Agent Boundaries",
 "description":"Understanding Agent Boundaries in Coder Tasks",
 "path":"./ai-coder/agent-boundary.md",
 "state": ["beta"]
 }
 ]
 },
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,121 @@
		# Agent Boundary

		Agent Boundaries are process-level firewalls that restrict and audit what autonomous programs, such as AI agents, can access and use.

		![Screenshot of Agent Boundaries blocking a process](../images/guides/ai-agents/boundary.png)Example of Agent Boundaries blocking a process.

		The easiest way to use Agent Boundaries is through existing Coder modules, such as the [Claude Code module](https://registry.coder.com/modules/coder/claude-code). It can also be ran directly in the terminal by installing the [CLI](https://github.com/coder/boundary).

		> [!NOTE]
		> The Coder Boundary CLI is free and open source. Integrations with the core product, such as with modules offering stronger isolation, are available to Coder Premium customers.

		## Supported Agents

		Boundary supports the securing of any terminal-based agent, including your own custom agents.

		## Features

		Boundaries extend Coder's trusted workspaces with a defense-in-depth model that detects and prevents destructive actions without reducing productivity by slowing down workflows or blocking automation. They offer the following features:

		- _Policy-driven access controls_: limit what an agent can access (repos, registries, APIs, files, commands)
		- _Network policy enforcement_: block domains, subnets, or HTTP verbs to prevent exfiltration
		- _Audit-ready_: centralize logs, exportable for compliance, with full visibility into agent actions

		## Getting Started with Boundary

		For Early Access, users can use Agent Boundaries through its [open source CLI](https://github.com/coder/boundary), which can be run to wrap any process or invoked through rules in a YAML file.


		### Wrap the agent process with the Boundary CLI

		Users can also run Boundary directly in your workspace and configure it per template or per script. While free tier users won't get centralized policy management or the deeper, "strong isolation," they can still enforce per workspace network rules and log decisions locally.


		1. Install the [binary](https://github.com/coder/boundary) into the workspace image or at start-up. You can do so with the following command:

		```hcl
		curl -fsSL https://raw.githubusercontent.com/coder/boundary/main/install.sh \| bash
		```

		1. Use the included `Makefile` to build your project. Here are a few example commands:

		```hcl
		make build # Build for current platform
		make build-all # Build for all platforms
		make test # Run tests
		make test-coverage # Run tests with coverage
		make clean # Clean build artifacts
		make fmt # Format code
		make lint # Lint code
jcjiang marked this conversation as resolved. Show resolvedHide resolved
		```

		From here, there are two ways to integrate the open source Boundary CLI into a workspace.

		#### Wrap a command inline with flags
		1. Wrap the tool you want to guard. Below are some examples of usage:

		```hcl
		# Allow only requests to github.com
		boundary --allow "github.com" -- curl https://github.com

		# Allow full access to GitHub issues API, but only GET/HEAD elsewhere on GitHub
		boundary \
		--allow "github.com/api/issues/*" \
		--allow "GET,HEAD github.com" \
		-- npm install

		# Default deny-all: everything is blocked unless explicitly allowed
		boundary -- curl https://example.com
		```

		Additional information, such as Allow Rules, can be found in the [repository README](https://github.com/coder/boundary).

		#### Use a config file (YAML) to set rules

		Another option is to define rules in a YAML file, which only needs to be invoked once as opposed to through flags with each command.
		1. Create a YAML file to store rules that will be applied to all `boundary` commands run in the Workspace. In this example, we call it `boundary.yaml`.

		A config example can be seen below:

		```hcl
		allow:

		- domain: [github.com](http://github.com)

		path: /api/issues/*

		- domain: [github.com](http://github.com)

		methods: [GET, HEAD]
		```
		1. Run a `boundary` command. For example:

		```hcl
		boundary run --config ./boundary.yaml -- claude
		```

		You will notice that the rules are automatically applied without any need for additional customization.

		### Unprivileged vs. Privileged Mode

		There are two approaches you can take to secure your agentic workflows with Agent Boundary.

		#### Unprivileged Mode

		In this case, a specific agent process or tool (for example, Claude Code or a CLI agent) runs inside of a constrained sandbox. This is the default mode in which Boundary will operate in and does not require root access.

		Agents are prevented from reaching restricted domains or exfiltrating data, without blocking the rest of the dev's environment.

		This is the fastest way to add real guardrails, but a determined user could still operate a tool outside of Boundary restrictions because the broader environment allows it. This mode relies on tools respecting certain settings, like HTTP proxies, and can lead to silent failures if a tool bypasses them.

		#### Privileged Mode

		In this case, boundaries are enforced at the level of the environment that the agent lives in. These are workspace- or session-level controls, including how the developer connects to it.

		Currently, this must be turned on with a flag and ran with higher-level permissions such as root access or `CapNetAdmin`.

		In addition to process-level egress rules, privileged mode locks down all pathways that could bypass policy, such as restricting or disabling SSH tunnels or parallel unbound IDEs. This delivers deterministic, policy-as-code enforcement and offers the highest assurance for regulated environments, but results in slightly more friction for mixed human-and-agent workflows.

		### Opting out of Boundary

		If you tried Boundary through a Coder module and decided you don't want to use it, you can turn it off by setting the flag to `boundary_enabled=false`.
Original file line number	Diff line number	Diff line change
Expand Up		@@ -16,4 +16,12 @@ In cases where the IDE is secondary, such as prototyping or long-running backgro

		![Coder Tasks UI](../images/guides/ai-agents/tasks-ui.png)

		[Learn more about Coder Tasks](./tasks.md) to how to get started and best practices.
		[Learn more about Coder Tasks](./tasks.md) for best practices and how to get started.

		## Secure Your Workflows with Agent Boundaries (Beta)

		AI agents can be powerful teammates, but must be treated as untrusted and unpredictable interns as opposed to tools. Without the right controls, they can go rogue.

		[Agent Boundaries](./agent-boundary.md) is a new tool that offers process-level safeguards that detect and prevent destructive actions. Unlike traditional mitigation methods like firewalls, service meshes, and RBAC systems, Agent Boundaries is an agent-aware, centralized control point that can either be embedded in the same secure Coder Workspaces that enterprises already trust, or used through an open source CLI.

		To learn more about features, implementation details, and how to get started, check out the [Agent Boundary documentation](./agent-boundary.md).
Original file line number	Diff line number	Diff line change
Expand Up		@@ -19,16 +19,10 @@ not access or upload sensitive information.

		Many agents require API keys to access external services. It is recommended to
		create a separate API key for your agent with the minimum permissions required.
		This will likely involve editing your template for Agents to set different scopes or tokens
		from the standard one.
		This will likely involve editing your template for Agents to set different scopes or tokens from the standard one.

		Additional guidance and tooling is coming in future releases of Coder.

		## Set Up Agent Boundaries(Premium)
		## Set Up Agent Boundaries

		Agent Boundaries add an additional layer and isolation of security between the
		agent and the rest of the environment inside of your Coder workspace, allowing
		humans to have more privileges and access compared to agents inside the same
		workspace.

		- [Contact us for more information](https://coder.com/contact) and for early access to agent boundaries
		Agent Boundaries are process-level "agent firewalls" that lets you restrict and audit what AI agents can access within Coder workspaces. To learn more about this feature, see [Agent Boundary](./agent-boundary.md).
Original file line number	Diff line number	Diff line change
Expand Up		@@ -907,6 +907,12 @@
		"description":"Connect to agents Coder with a MCP server",
		"path":"./ai-coder/mcp-server.md",
		"state": ["beta"]
		},
		{
		"title":"Agent Boundaries",
		"description":"Understanding Agent Boundaries in Coder Tasks",
		"path":"./ai-coder/agent-boundary.md",
		"state": ["beta"]
		}
		]
		},
Expand Down