codespaces

Dev Container configurations for AI development with Go, Rust, Node.js, Java, and modern AI tools. Built on a flexible Just-based recipe system that lets you install tools on-demand or use fully prebuilt images.

Containers

AI - just:latest

AI - just:all

Go - default:latest

Running Outside of Dev Containers

Pre-built container images are automatically published to GitHub Container Registry via GitHub Actions workflow. You can optionally clone this repository to use the included Justfile recipes.

Clone the repository (optional, for Justfile support)

git clone https://github.com/asw101/codespaces.git
cd codespaces

Using Docker

Pull and run the container with Docker on any platform:

just:latest (minimal install-on-demand image):

docker run --rm -it \
  --memory 4g \
  --cpus 2 \
  -p 8080:8080 \
  -v "$(pwd)":/pwd \
  -w /pwd \
  ghcr.io/asw101/codespaces/just:latest bash

just:all (fully prebuilt image with all tools):

docker run --rm -it \
  --memory 4g \
  --cpus 2 \
  -p 8080:8080 \
  -v "$(pwd)":/pwd \
  -w /pwd \
  ghcr.io/asw101/codespaces/just:all bash

Using macOS Containers

Start the container system and run the container using Apple's container:

container system start || true

Pull and run the container using macOS container:

just:latest (minimal install-on-demand image):

container run --rm -it \
  --memory 4g \
  --cpus 2 \
  --publish 8080:8080 \
  --volume "$(pwd)":/pwd \
  --workdir /pwd \
  ghcr.io/asw101/codespaces/just:latest bash

just:all (fully prebuilt image with all tools):

container run --rm -it \
  --memory 4g \
  --cpus 2 \
  --publish 8080:8080 \
  --volume "$(pwd)":/pwd \
  --workdir /pwd \
  ghcr.io/asw101/codespaces/just:all bash

Using Justfile Recipes

If you've cloned the repository, you can use the Justfile recipes to build and run containers:

# Docker
just docker-build        # Build the just:latest image
just docker-build-all    # Build the just:all image
just docker-run          # Run the container

# macOS container
just macos-build-container      # Build the just:latest image
just macos-build-container-all  # Build the just:all image
just macos-run-container        # Run the container