Skip to content

Create and manage isolated islands using Docker with ease.

License

Notifications You must be signed in to change notification settings

itzCozi/coderaft

coderaft

Isolated development environments using Docker islands

CI Go Report Card License

coderaft creates isolated development environments inside Docker islands. Each project lives in its own disposable container while your code stays organized on the host.

Features

  • One-command clonecoderaft clone <repo> auto-detects stack and sets up instantly
  • Instant setup — Create environments in seconds
  • Isolated — Each project in its own Docker island
  • Reproducible — Commit coderaft.json for consistent team environments
  • Package tracking — Automatically records installs from 30+ package managers (apt, pip, npm, cargo, go, brew, and more)
  • Lock files — Pin exact environment state with checksummed coderaft.lock.json
  • Secrets management — AES-256 encrypted vault for API keys and credentials
  • Docker-in-Docker — Use Docker inside your island out of the box
  • Cross-platform — Linux, macOS, and Windows
  • Simple config — One small JSON file, no frameworks

Why coderaft?

Problem Solution
"Works on my machine" Every project runs in an identical, isolated island
Dependency conflicts Each island has its own dependencies, no host pollution
Complex setup scripts One JSON config, one command to start
Heavy VMs or slow tools Lightweight Docker containers, instant startup
Cluttered host system Your host stays clean; everything runs in islands
Team onboarding friction Commit coderaft.json, teammates run coderaft up

Install

Linux

curl -fsSL https://raw.githubusercontent.com/itzcozi/coderaft/main/scripts/install.sh | bash
# or mirror: curl -fsSL https://coderaft.ar0.eu/install.sh | bash

macOS

curl -fsSL https://raw.githubusercontent.com/itzcozi/coderaft/main/scripts/install-macos.sh | bash
# or mirror: curl -fsSL https://coderaft.ar0.eu/install-macos.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/itzcozi/coderaft/main/scripts/install.ps1 | iex
# or mirror: irm https://coderaft.ar0.eu/install.ps1 | iex

Manual builds: See the Installation Guide for build instructions on all platforms.

Requires Docker. On Windows/macOS, use Docker Desktop.

Quick Start

One-Command Project Setup

Clone any repo and start coding in seconds:

coderaft clone https://github.com/user/repo
# Auto-detects stack, creates island, runs setup → ready to code in 30 seconds

Manual Setup

# Create a project
coderaft init my-project

# Enter the environment
coderaft shell my-project

# Run a command
coderaft run my-project "python --version"

# List environments
coderaft list

# Clean up
coderaft destroy my-project

Team Workflow

Commit coderaft.json to your repo. Teammates just run:

coderaft up

Documentation

Full docs, guides, and examples: coderaft.ar0.eu

License

MIT — see LICENSE


Created by BadDeveloper with 💚

About

Create and manage isolated islands using Docker with ease.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Contributors