Cloud Environment Setup

Set up a fresh cloud/mobile Claude Code environment with all tools needed for AILANG development.

Quick Start

Run the setup script to install all required tools:

.claude/skills/cloud-setup/scripts/setup.sh

Or verify an existing environment:

.claude/skills/cloud-setup/scripts/verify.sh

When to Use This Skill

Use this skill when:

• Starting a new cloud/mobile Claude Code session
• go, make, or gh commands are not found
• User says "setup cloud", "setup environment", "install tools"
• Build commands fail due to missing tools
• User mentions "mobile Claude Code" or "cloud environment"

Environment Requirements

Required Tools

Tool	Purpose	Minimum Version
Go	Build AILANG	1.24+
make	Build automation	GNU Make 4+
gh	GitHub CLI	2.0+
git	Version control	2.0+

Resource Requirements

Resource	Minimum	Recommended
RAM	4 GB	8+ GB
Disk	5 GB free	10+ GB
CPUs	2	4+
Network	Required	Required

Setup Workflow

Step 1: Assess Current Environment

# Check what's available
which go make gh git 2>/dev/null
go version 2>/dev/null

Step 2: Fix DNS (if needed)

Cloud environments sometimes have broken DNS. Fix with:

echo "nameserver 8.8.8.8" > /etc/resolv.conf
echo "nameserver 8.8.4.4" >> /etc/resolv.conf

Step 3: Install Go

# Install via apt (may get older version)
apt-get update && apt-get install -y golang-go make

# OR install specific version directly
wget --no-check-certificate https://go.dev/dl/go1.24.4.linux-amd64.tar.gz -O /tmp/go.tar.gz
rm -rf /usr/local/go && tar -C /usr/local -xzf /tmp/go.tar.gz
export PATH=/usr/local/go/bin:$PATH

Step 4: Install GitHub CLI

# Download and install
curl -L https://github.com/cli/cli/releases/download/v2.63.2/gh_2.63.2_linux_amd64.tar.gz -o /tmp/gh.tar.gz
tar -xzf /tmp/gh.tar.gz -C /tmp
mv /tmp/gh_*/bin/gh /usr/local/bin/
rm -rf /tmp/gh*

Step 5: Configure Go Environment

export PATH=/usr/local/go/bin:$PATH
export GOTOOLCHAIN=local      # Prevent auto-download of newer Go
export GOPROXY=direct         # Bypass proxy if blocked

Step 6: Build AILANG

# Download dependencies
go mod download

# Build
make build

# Verify
./bin/ailang run examples/runnable/hello.ail

Available Scripts

scripts/setup.sh

Full automated setup - installs Go, make, gh, and builds AILANG.

Usage:

.claude/skills/cloud-setup/scripts/setup.sh

What it does:

1. Checks current environment
2. Fixes DNS if needed
3. Installs Go 1.24.4
4. Installs make
5. Installs GitHub CLI
6. Downloads Go modules
7. Builds AILANG
8. Runs verification

scripts/verify.sh

Verify environment is correctly set up.

Usage:

.claude/skills/cloud-setup/scripts/verify.sh

Checks:

• Go version and PATH
• make availability
• gh CLI availability
• AILANG binary exists
• AILANG can run examples
• Core tests pass

Resources

Troubleshooting Guide

See `resources/troubleshooting.md` for common issues and solutions.

Known Issues

1. Go Toolchain Auto-Download

Symptom: Go tries to download newer toolchain, fails with network error

Solution: Set GOTOOLCHAIN=local

2. DNS Resolution Failures

Symptom: dial tcp: lookup ... on [::1]:53: connection refused

Solution: Add Google DNS to /etc/resolv.conf:

echo "nameserver 8.8.8.8" > /etc/resolv.conf

3. Go Module Proxy Blocked

Symptom: Timeout connecting to proxy.golang.org or storage.googleapis.com

Solution: Use direct downloads:

export GOPROXY=direct
go mod download

4. SSL/TLS Handshake Failures

Symptom: curl: (35) ... sslv3 alert handshake failure

Solution: Use wget --no-check-certificate instead of curl

5. Missing Basic Commands

Symptom: head, tail, grep not found

Solution: Either install coreutils or avoid piping:

# Instead of: command | head -20
# Just run: command
# And manually inspect output

Post-Setup Checklist

After setup, verify you can:

• go version shows 1.24+
• make --version works
• gh --version works
• ./bin/ailang run examples/runnable/hello.ail outputs "Hello, AILANG!"
• go test ./internal/lexer/... passes

Environment Variables

Set these in your session for reliable builds:

export PATH=/usr/local/go/bin:$PATH
export GOTOOLCHAIN=local
export GOPROXY=direct

What You Can Do After Setup

With environment configured, you can:

1. Build AILANG: make build
2. Run programs: ./bin/ailang run --caps IO file.ail
3. Run tests: go test ./internal/...
4. Work on design docs: Full read/write access
5. Commit and push: Git operations work
6. UI development: Node/npm available for ui/ work