Skip to content

enhance: Add resource planning for parallel AI agent deployments#16

Merged
williamzujkowski merged 1 commit intomainfrom
enhance/parallel-agent-resources
Feb 2, 2026
Merged

enhance: Add resource planning for parallel AI agent deployments#16
williamzujkowski merged 1 commit intomainfrom
enhance/parallel-agent-resources

Conversation

@williamzujkowski
Copy link
Copy Markdown
Owner

Summary

  • Increase default RAM from 8GB to 16GB for Claude CLI memory leak mitigation
  • Add --memory and --vcpus flags to setup_cloud.sh
  • Increase default swap from 4GB to 8GB (configurable via SWAP_SIZE env var)
  • Enhance vm-health-check with Claude CLI memory tracking and warnings
  • Add RESOURCES.md with parallel deployment guide and memory calculator
  • Update CLAUDE.md quick reference with new options

Context

Claude CLI has documented memory leaks reaching 13-120GB+ in extended sessions (see #4953, #11315). These changes ensure VMs can handle memory pressure and provide operators with tools to plan multi-clone deployments.

New Commands

# Setup with custom resources
./setup_cloud.sh --memory 16384 --vcpus 8

# Lightweight clones for parallel work
./clone_manager.sh create ubuntu2404-agent --linked --memory 8192 --vcpus 2

Test plan

  • Verify setup_cloud.sh --help shows new options
  • Verify setup_cloud.sh --memory 8192 creates VM with 8GB RAM
  • Verify vm-health-check inside VM shows Claude memory tracking
  • Verify shellcheck passes on all modified scripts

🤖 Generated with Claude Code

- Increase default RAM from 8GB to 16GB (Claude CLI memory leak mitigation)
- Add --memory and --vcpus flags to setup_cloud.sh
- Increase default swap from 4GB to 8GB (configurable via SWAP_SIZE)
- Enhance vm-health-check with Claude CLI memory tracking and warnings
- Add RESOURCES.md with parallel deployment guide and memory calculator
- Update CLAUDE.md quick reference with new options

Claude CLI has documented memory leaks reaching 13-120GB+ in extended
sessions. These changes ensure VMs can handle memory pressure and provide
operators with tools to plan multi-clone deployments on hosts with
limited RAM.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@williamzujkowski williamzujkowski merged commit 9558eb7 into main Feb 2, 2026
2 checks passed
@williamzujkowski williamzujkowski deleted the enhance/parallel-agent-resources branch February 2, 2026 14:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant