coderaft

Isolated development environments for anything

coderaft creates isolated development environments, contained in a project's Docker island. Each project operates in its own disposable environment, while your code remains neatly organized in a simple, flat folder on the host machine.

Features

• Instant Setup - Create isolated development environments in seconds
• Docker-based - Leverage the power of islands (containers) for consistent environments
• Clean Organization - Keep your code organized in simple, flat folders
• Configurable - Define your environment with simple JSON configuration
• Disposable - Easily destroy and recreate environments as needed
• Isolated - Each project runs in its own island, preventing conflicts
• Docker-in-Docker - Use Docker within your coderaft environments by default
• Cross-platform - Supports Linux (Debian, Ubuntu, Fedora, Arch, Alpine, and more), macOS, and Windows
• Well Tested - Comprehensive test suite

Why coderaft?

coderaft focuses on fast, disposable, Docker-native development environments with simple, commit-friendly config.

• Minimal config: a small JSON file, no heavy frameworks
• Clean host workspace: flat folders, no complex mounts
• Reproducible: isolated per-project islands you can destroy/recreate anytime
• Docker-in-Docker ready: use Docker inside your environment out of the box
• Cross-platform: runs on Linux, macOS, and Windows wherever Docker is available

Installation

Linux (Debian/Ubuntu/Fedora/Arch/Alpine and more)

curl -fsSL https://raw.githubusercontent.com/itzcozi/coderaft/main/install.sh | bash

macOS

curl -fsSL https://raw.githubusercontent.com/itzcozi/coderaft/main/install-macos.sh | bash

Or manually with Homebrew:

brew install go git docker --cask
git clone https://github.com/itzcozi/coderaft.git && cd coderaft
make build && sudo make install

Windows

# PowerShell (run as Administrator)
irm https://raw.githubusercontent.com/itzcozi/coderaft/main/install.ps1 | iex

Or manually:

# Prerequisites: Docker Desktop, Go, Git
git clone https://github.com/itzcozi/coderaft.git; cd coderaft
.\build.ps1 -Install

Note: coderaft requires Docker on all platforms. On Windows, use Docker Desktop. On macOS, use Docker Desktop for Mac.

Quick Start

1. Initialize a new project

   coderaft init my-project

2. Enter the development environment

   coderaft shell my-project

3. Run commands in the environment

   coderaft run my-project "python --version"

4. List your environments

   coderaft list

5. Clean up when done

   coderaft destroy my-project

Shared configs

Commit a coderaft.json to your repo so teammates can just:

coderaft up

Optional: mount your local dotfiles into the island

coderaft up --dotfiles ~/.dotfiles

Documentation

For detailed documentation, guides, and examples, visit:

coderaft.ar0.eu

License

This project is licensed under the MIT License. See the LICENSE file for details.

Created by BadDeveloper with 💚