Operations Runbook

What to run and when - operational commands for Vant.

Notifications

Vant supports Slack and Discord webhooks for brain sync and alerts.

Environment

Configure webhook URLs:

# Slack
SLACK_WEBHOOK_URL=https://hooks.slack.com/services/xxx

# Discord
DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/xxx

Send Notification

Send a message to Slack or Discord:

const notifications = require('./lib/notifications');

// Slack
await notifications.slack('Brain synced!', { 
  channel: '#alerts',
  username: 'VANT'
});

// Discord
await notifications.discord('Brain synced!');

Auto-Notify on Sync

Automatically notify when brain syncs:

// In your sync script
await vant.sync();
await notifications.discord('Brain updated');

Daily Operations

Run these commands day-to-day.

Health Check

Check Vant health status:

vant health

Expected output:

• ✓ GitHub connection OK
• ✓ Brain loaded
• ✓ Rate limit OK

Check Rate Limit

View remaining API quota:

vant rate

Session Summary

Get session statistics:

vant summary

Shows:

• Memory usage
• Sessions today
• Tokens used

Troubleshooting

Fix common issues.

Vant Won’t Start

Debug startup failures.

Debug steps:

# Check logs
vant health

# Verify .env
cat .env

# Verify config
cat config.ini

Brain Won’t Load

Debug load failures.

Reload manually:

# Check GitHub sync
vant sync --pull

# Manual reload
vant load

Rate Limit Hit

Handle API quota exceeded.

Check and wait:

# Check current limit
vant rate

# Wait for reset (GitHub resets hourly)
# Or use different token

Recovery

Restore from failures.

Full Recovery

Run full recovery sequence.

Pull, reload, verify:

# Pull latest
vant sync --pull

# Reload brain
vant load

# Verify
vant health

Reset State

Clear state and restart.

Backup, clear, restart:

# Backup state
cp states/active/current.json states/backup.json

# Clear state
echo '{}' > states/active/current.json

# Restart
vant start

Reinstall

Clean reinstall of Vant.

Reinstall steps:

# Clear node_modules
rm -rf node_modules

# Install fresh
npm install

# Test
vant health

Maintenance

Keep Vant running smoothly.

Manual Sync

Sync brain with GitHub:

# Pull only
vant sync --pull

# Push only
vant sync --push

# Full sync
vant sync

Check for Updates

Check for updates:

vant update

View Changelog

View recent changes.

vant changelog

Monitoring

Track Vant health and activity.

Watch Mode

Watch for changes.

vant watch

Monitors GitHub for changes - useful for multi-agent.

MCP Health

MCP server functionality.

# If MCP running
curl http://localhost:3456/health

Log Monitoring

Logging configuration.

# View last 100 lines
tail -100 .vant.log

# Follow logs
tail -f .vant.log

Emergency Contacts

Telegram Bot

Control Vant via Telegram - brain queries and commands.

Running Bot

Run the bot in production.

export TELEGRAM_BOT_TOKEN=your_bot_token
vant bot

Commands

Custom Commands

Add custom commands.

const telegram = require('./lib/telegram');

telegram.onCommand('status', async (msg) => {
    await telegram.send(msg.chat, 'VANT is running');
});

await telegram.startPolling();

Common Commands

See also: Troubleshooting, CLI Reference