Quick Start

Get started in minutes. Make sure you have coderaft installed first.

Clone an Existing Project

The fastest way to start working on any project:

coderaft clone https://github.com/user/repo

That’s it! coderaft will:

Clone the repository
Auto-detect the tech stack (Python, Node.js, Go, etc.)
Create an isolated island with the right tools
Install dependencies

Ready to code in ~30 seconds.

# Enter the environment
coderaft shell repo

# Your code is at /island
cd /island

Create a New Project

coderaft init my-app --template python

This creates a Python environment at ~/coderaft/my-app/.

Enter the Environment

coderaft shell my-app

You’re now inside an isolated island. The prompt changes to show you’re in the coderaft environment.

Work Inside the Island

# Check available tools
python3 --version
pip3 --version

# Your files are at /island
cd /island

# Install packages (recorded for reproducibility)
pip3 install flask requests

# View recorded history
coderaft history

Run Code

# Create a simple app
cat > /island/app.py << 'EOF'
from flask import Flask
app = Flask(__name__)

@app.route('/')
def hello():
    return 'Hello from coderaft!'

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=5000)
EOF

# Run it
python3 app.py

Manage Projects

# List projects
coderaft list

# Create more
coderaft init node-app --template nodejs
coderaft init go-service --template go

# Each is fully isolated
coderaft shell node-app

Clean Up

# Stop and remove island (keeps files)
coderaft destroy my-app

# Or just stop it
coderaft stop my-app

# Files remain at ~/coderaft/my-app/

Docker Access

Islands have Docker access by default via the mounted Docker socket. Build images, run containers, and use Docker Compose inside your island.