Skip to content

agentfile

A CLI tool for managing sandboxed agent containers.

pipeline status coverage report latest release pre-commit cici enabled code style: prettier

About

Agents can take literally any action available to them with no oversight. They can and will:

  • Install software
  • Use your credentials
  • Access remote APIs
  • Delete your filesystem/database/production cluster

"The model ate my homework" is not a valid excuse. Lock it down!

agentfile wraps container lifecycle management into a single command. Define your sandbox environment in an agentfile.yaml, and the CLI handles building, tagging, and running it with appropriate resource constraints.

Quick start

agentfile init
agentfile run

Drops you into OpenCode with the current directory mounted where the agent can see it and agent configuration that persists across containers.

See the Installation page to get started.

License

Copyright 2026 UL Research Institutes.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.