Updating Agentwise

Keep your Agentwise installation up-to-date with the latest features and improvements

Automatic Update (Recommended)

The easiest way to update Agentwise using the built-in command

bash
# Run this command in Claude Code
/update-agentwise

What it does:

  • ✓ Checks your current version
  • ✓ Downloads latest from GitHub
  • ✓ Preserves your settings and projects
  • ✓ Rebuilds the project
  • ✓ Restarts services automatically
  • ✓ Shows changelog of new features

🔧 Manual Update

If you prefer to update manually or the automatic update isn't working:

Step-by-Step Manual Update

bash
# 1. Navigate to Agentwise directory
cd ~/agentwise

# 2. Stash any local changes
git stash

# 3. Pull latest changes
git pull origin main

# 4. Install new dependencies
npm install

# 5. Rebuild the project
npm run build

# 6. Restart Agentwise
node dist/index.js

# 7. Verify the update
echo "✅ Updated to latest version!"

✨ Latest Features in v2.3.1

NEW

Self-Improving Agents

Agents now learn from every task and improve over time with persistent knowledge storage

NEW

15-30% Token Optimization

Verified token reduction through Context 3.0 + Knowledge Graph combined systems

IMPROVED

Agent Claim Verification

Automatic validation of all claims made by AI agents with trust scoring

IMPROVED

Update Command

New /update-agentwise command for seamless updates without manual steps

🔍 Checking for Updates

Check Current Version

bash
# Check your current Agentwise version
cat ~/agentwise/package.json | grep version

Check Latest Version

bash
# Check the latest version on GitHub
curl -s https://api.github.com/repos/VibeCodingWithPhil/agentwise/releases/latest | grep tag_name

View Changelog

bash
# View recent changes
cat ~/agentwise/CHANGELOG.md | head -50

↩️ Rolling Back

If you experience issues after updating, you can rollback to a previous version:

Rollback Instructions

bash
# 1. Navigate to Agentwise
cd ~/agentwise

# 2. Check available versions
git tag -l

# 3. Checkout a specific version (example: v2.1.0)
git checkout v2.1.0

# 4. Reinstall dependencies for that version
npm install

# 5. Rebuild
npm run build

# 6. Restart
node dist/index.js

🛠️ Troubleshooting Updates

Permission Errors

If you get permission errors:

bash
sudo chown -R $(whoami) ~/agentwise

Build Failures

If the build fails:

bash
# Clear node_modules and reinstall
rm -rf node_modules package-lock.json
npm install
npm run build

Git Conflicts

If you have local changes:

bash
# Stash your changes first
git stash
git pull origin main
git stash pop  # To restore your changes

⚙️ Auto-Update Configuration

Enable Automatic Updates

Configure Agentwise to check for updates automatically

Add to your ~/.agentwise-config.json:

json
{
  "updates": {
    "autoCheck": true,
    "checkInterval": "daily",
    "autoInstall": false,
    "notifyOnUpdate": true
  }
}