Materials for a hands-on workshop.
A coding agent can be redirected by instructions hidden in anything it reads, for example a web page, an installed dependency or a comment on an issue. It acts with all the permissions of the user who started it. You can't reliably prevent the agent from being tricked, but you can limit the damage it can cause.
In this workshop, you run an agent in an OpenShell sandbox. At the end, the agent can work on your GitHub repository and reach its LLM provider.
| # | Chapter | What you do |
|---|---|---|
| 0 | Prerequisites | Prepare your computer before the workshop. |
| 1 | Introduction | Learn the risks and the parts of OpenShell. |
| 2 | Gateway and drivers | Check the control plane and pin the Docker driver. |
| 3 | Sandboxes | Create sandboxes and manage their lifecycle. |
| 4 | Custom base image | Build an image with tools and agents. |
| 5 | Providers and profiles | Give access to a single repository without exposing your token. |
| 6 | Custom policy | Allow the agent to reach its LLM provider and save the policy. |
Each chapter explains the key concepts first, then guides you step by step.
Go to Prerequisites.