Cloud Environment Setup

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

Resource Requirements

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