dependencies

name	dependencies
description	Use when installing system packages, Python libs, or JS/TS modules persistent. Use when you need a tool or library that isn't pre-installed, or when the user asks to install something.

Installing Dependencies

You have no root or sudo access. Everything outside ~/ (/home/agent/) is lost on container restart. Use the tools below to install what you need.

What	How	Example
System packages	brew install <pkg>	brew install imagemagick
Python packages	pip install <pkg>	pip install requests

Search for Homebrew packages: brew search <name> or https://formulae.brew.sh

Remove a Homebrew package: brew uninstall <package>

Survive Restarts

Packages installed via Homebrew persist across restarts (stored in /home/linuxbrew/.linuxbrew/). Python packages installed via pip outside the home directory may be lost — use pip install --user <pkg> or add install commands to ~/user-extensions.sh:

#!/bin/bash
pip install requests

This script runs automatically on every container start.

Gotchas

• Never use apt-get or sudo — you don't have access. Use brew install instead.
• Homebrew package names usually match what you expect (e.g. brew install python3, brew install ffmpeg).
• First brew install may be slow (updates tap). Use HOMEBREW_NO_AUTO_UPDATE=1 brew install <pkg> to skip.
• No Docker daemon available — you cannot run docker commands.

Pre-installed

Bun, Node.js, Python, git, sqlite3, curl, wget, jq, ripgrep, ffmpeg, pandoc, typst, chromium, browser (headless web CLI — see browser skill)