Remote Work Skill

/amplihack:remote

When to Use

• Run long-running tasks on remote VMs
• Leverage more powerful Azure compute
• Distribute work across multiple machines
• Isolate experimental or risky work
• Work in specific Azure regions

How It Works

• "Run this remotely"
• "Execute on an eastus VM"
• "Offload this to Azure"
• "Use a remote machine for this"

1. Extract your task description
2. Detect region preferences (if mentioned)
3. Recommend appropriate VM size based on task complexity
4. Execute

   /amplihack:remote

   with proper options
5. Guide you on accessing results

Region Detection

• "eastus", "east us" → --region eastus
• "westus", "west us" → --region westus
• "centralus" → --region centralus
• (and other Azure regions)

VM Size Recommendations

• Keywords: "quick", "simple", "small", "analyze"
• Size: s (8GB RAM)

• Keywords: "implement", "feature", "refactor"
• Size: m (64GB RAM) - default

• Keywords: "large", "comprehensive", "complex", "entire codebase"
• Size: l (128GB RAM)

• Keywords: "intensive", "heavy", "massive"
• Size: xl (256GB RAM)

Instructions

1. Parse the user's request to extract:
   • The task description
   • Region preference (if mentioned)
   • Complexity hints for VM sizing
2. Determine VM size based on keywords:
   • Default to "m" unless keywords suggest otherwise
   • Use "s" for simple/quick tasks
   • Use "l" for large/complex tasks
   • Use "xl" for intensive/massive tasks
3. Construct the command:

   /amplihack:remote --region {region} --vm-size {size} auto "{task}"

   If no region mentioned, omit --region (uses azlin default)
4. Execute the command using the SlashCommand tool
5. Guide the user on next steps:
   • Results will be in

     ~/.amplihack/.claude/runtime/logs/remote/

   • Git branches in

     remote-exec/

     namespace
   • How to view logs and integrate changes

Examples

Example 1: Simple with Region

I'll execute this analysis on a remote Azure VM in eastus.

Detected:
- Task: analysis work
- Region: eastus
- Size: s (small - suitable for analysis)

Executing: /amplihack:remote --region eastus --vm-size s auto "analysis work"

Example 2: Large Refactoring

I'll execute this comprehensive refactoring on a remote Azure VM in westus2.

Detected:
- Task: comprehensive refactoring
- Region: westus2
- Size: l (large - for comprehensive work)

Executing: /amplihack:remote --region westus2 --vm-size l auto "comprehensive refactoring"

Example 3: No Region Specified

I'll execute this task on a remote Azure VM using your default region.

Detected:
- Task: [extract from context]
- Region: default (from azlin config)
- Size: m (medium - standard)

Executing: /amplihack:remote --vm-size m auto "[task]"

Result Integration

Remote execution complete!

Results:
- Logs: .claude/runtime/logs/remote/
- Branches: Check `git branch -r | grep remote-exec`
- Integration: Review changes and merge if ready

To view logs:
  cat .claude/runtime/logs/remote/remote-exec-*.log

To merge remote changes:
  git fetch
  git merge remote-exec/main

Error Handling

azlin configure

azlin connect <vm-name>

Best Practices

• Keep git state clean before remote execution
• Use

  .env

  for secrets (never hardcode)
• Monitor Azure costs with

  azlin list

• Clean up VMs after debugging with

  azlin kill <vm-name>

Token Budget

• Core instructions: ~1,200 tokens
• Examples and guidance: ~400 tokens
• Total: ~1,600 tokens (well under 2,000 limit)

See Also

• /amplihack:remote

  - Direct command interface
• Azlin documentation: https://github.com/rysweet/azlin
• Remote execution module:

  ~/.amplihack/.claude/tools/amplihack/remote/README.md