Back
11/65
Lesson 11
4 min
Keeping Updated
Maintain and upgrade your environment
Ready to level up?
Mark complete to track your learning progress.
Maintain and upgrade your environment
Mark complete to track your learning progress.
Learn how to keep your ACFS tools current.
Your VPS has 30+ tools installed. Each one gets improvements:
ACFS provides a single command to update everything:
acfs-update
That's it! This updates:
$ acfs-updateStandard update across all components. Everything pulls cleanly.
If you just want the latest agent versions:
acfs-update --agents-only
apt updates can be slow. Skip them when you're in a hurry:
acfs-update --no-apt
See what would be updated without changing anything:
acfs-update --dry-run
The Agent Flywheel stack (ntm, slb, ubs, etc.) is included by default. Skip it when you want a faster run:
acfs-update --no-stack
For hands-off maintenance, use quiet mode:
acfs-update --yes --quiet --no-self-update
This runs without prompts, only shows errors, and leaves the ACFS tree itself alone. The shipped nightly timer runs exactly this.
# Edit crontabcrontab -e# Add this line for weekly Sunday 3am updates0 3 * * 0 $HOME/.local/bin/acfs-update --yes --quiet --no-self-update >> $HOME/.acfs/logs/cron-update.log 2>&1
Every update is logged:
1# List recent logs2ls -lt ~/.acfs/logs/updates/ | head -534# View the most recent log5cat ~/.acfs/logs/updates/$(ls -1t ~/.acfs/logs/updates | head -1)67# Watch a running update8tail -f ~/.acfs/logs/updates/$(ls -1t ~/.acfs/logs/updates | head -1)
If you see "apt is locked by another process":
# See which process is holding the lock sudo fuser -v /var/lib/dpkg/lock-frontend || true # Wait for other apt operations to finish, then repair interrupted packages sudo dpkg --configure -a
Try updating directly:
# Claude claude update --channel latest # Codex bun install -g --trust @openai/codex@latest # Antigravity agy update
Check git remote access:
git -C ~/.oh-my-zsh remote -v
acfs-updateacfs-update --no-stackacfs-update --agents-onlyacfs-update --no-aptacfs-update --dry-runacfs-update --yes --quiet --no-self-updateacfs-update --helpRecommendations:
You now have:
Go build something amazing!