This is the repository that has all the scripts for bootstrapping a development environment on my computers.

• bootstrap.sh - This will install the bare minimum necessary for doing the provisioning
• justfile - This is the main script for defining all the available options. just help

We need to get some base tooling installed so that the rest of the tooling can depend on it, so the first step is to run ./bootstrap.sh

To get everything installed and provisioned you can run:

just install 

To update the plugins used in nvim:

:PackerUpdate 

I currently use JetBrainsMono Nerd Font patched from here:

• https://www.nerdfonts.com/font-downloads

claude-jail runs Claude Code in a secure Docker Desktop sandbox with project isolation and optional custom environments.

# Run Claude Code in sandbox (current directory) claude-jail # Or use the alias cj

Claude will run in an isolated Docker container with:

• Your project mounted at current directory
• SSH keys and Git credentials available
• AWS credentials mounted (if ~/.aws exists)
• Agent skills from ~/code/sontek/agent-skills
• Development tools from nix/mise automatically mounted

For projects needing specific dependencies (Python packages, Node modules, etc.), create .claude/Dockerfile:

# Copy a template to your project cp ~/code/sontek/homies/docker/claude-templates/python.Dockerfile .claude/Dockerfile # claude-jail automatically builds and caches it claude-jail

Available templates:

• python.Dockerfile - Python 3.12 + uv/Poetry + Just + AWS CLI
• nodejs.Dockerfile - Node.js 20 + npm/pnpm + AWS CLI
• golang.Dockerfile - Go 1.21 + AWS CLI

See docker/claude-templates/README.md for details.

ralph orchestrates Claude Code through structured phases automatically:

ralph "implement user authentication"

Ralph workflow:

1. PLAN - Analyze requirements and existing code
2. IMPLEMENT - Write code and tests
3. TEST - Run tests, linters, type checkers (auto-discovers project tools)
4. REVIEW - Manual code review for bugs and quality
5. COMMIT - Create git commit (auto-skipped if tests/review failed)

Features:

• Automatic task retry (skips after 3 failures to prevent infinite loops)
• Phase 5 (COMMIT) auto-skipped if Phase 3 or 4 failed
• Decision logging in .ralph/decisions.md
• All artifacts archived in .ralph/runs/ralph-YYYYMMDD-HHMMSS/

• CLAUDE_JAIL_DOCKER.md - Full claude-jail documentation
• CLAUDE_DOCKERFILE_GUIDE.md - Custom Docker image guide
• docker/claude-templates/ - Reusable templates for common stacks
• docs/archive/ - Historical implementation and design docs

docker-status # Check if Docker Desktop is running claude-containers # List Claude sandbox containers claude-cleanup # Remove stopped containers ralph-status # Show Ralph state ralph-log # Show Ralph audit logs ralph-clean # Clean Ralph state/logs ralph-help # Show Ralph usage