---
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

```bash
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

```bash
# 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
```bash
agex sync
```

### agex.toml out of sync with disk
```bash
agex clean && agex sync
```

### Want to add a new team member
Tell them to run:
```bash
git clone <repo>
cd <repo>
agex sync
```

### Want to see what's installed
```bash
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