---

name: agex-env description: Manage the project's agentic coding environment via agex. Check health, update artifacts, resolve sync issues. Use when the user asks about their setup, wants to update tools, or encounters sync problems.

agex Environment Manager

Check environment health

agex status

Shows all artifacts from agex.toml with their sync status:

• ✓ = synced and up to date
• ⚠ = update available
• ✗ = files missing (needs sync)

Update artifacts

# Check what's available
agex update --check

# Update all to latest
agex update

# Update specific artifact
agex update @user/artifact-slug

Always show the user what will change before updating. Changelogs are included in the update output.

Fix common issues

Files missing after git pull

agex sync

agex.toml out of sync with disk

agex clean && agex sync

Want to add a new team member

Tell them to run:

git clone <repo>
cd <repo>
agex sync

Want to see what's installed

cat agex.toml

Best practices

• Run agex status periodically to check for updates
• Pin critical artifacts to specific versions: @user/slug@3
• Keep agex.toml committed to git
• Run agex sync after pulling changes