create-claude-docker 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 create-claude-docker contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,326 @@
+# create-claude-docker
+
+Create Docker-based Claude Code development environment with **Z.AI GLM-4.7** support.
+
+[![npm version](https://img.shields.io/npm/v/create-claude-docker.svg)](https://www.npmjs.com/package/create-claude-docker)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Features
+
+- 🐳 **Docker-based**: Isolated environment for each project
+- 🔑 **Auto-configured**: API key injection on container start
+- 🤖 **Z.AI GLM-4.7**: Pre-configured for Z.AI's Claude-compatible models
+- 👤 **Non-root user**: Supports `--dangerously-skip-permissions` flag
+- 🛠️ **Default agents**: Pre-configured specialized agents (backend, frontend, debugging, etc.)
+
+## Quick Start
+
+### Create a new project with npx
+
+```bash
+# Interactive mode
+npx create-claude-docker my-project
+
+# With options
+npx create-claude-docker my-project --description "My AI project" --author "Your Name"
+```
+
+### CLI Options
+
+| Option | Alias | Description |
+|--------|-------|-------------|
+| `--description` | `-d` | Project description |
+| `--author` | `-a` | Author name |
+
+### After creation
+
+```bash
+cd my-project
+
+# Add your Z.AI API key
+nano .env
+
+# Build and start
+npm run docker:build
+npm run docker:up
+
+# Run Claude Code
+npm run claude:unsafe
+```
+
+## Manual Setup (Alternative)
+
+### Option 2: Using Z.AI GLM-4.7 Models
+
+Z.AI provides GLM-4.7 models that are compatible with Claude Code through an Anthropic-compatible API endpoint.
+
+1. **Get Z.AI API key:**
+   - Visit: https://z.ai/manage-apikey/apikey-list
+   - Or: https://open.bigmodel.cn/
+   - Sign up and get your API key
+
+2. **Configure environment:**
+   ```bash
+   cp .env.example .env
+   # Edit .env and set your Z.AI API key:
+   ZAI_API_KEY=your-zai-api-key-here
+   ```
+
+3. **Build and start:**
+   ```bash
+   npm run docker:build
+   npm run docker:up
+   ```
+   
+   The container will **automatically configure** Claude Code with your API key on startup. You should see:
+   ```
+   🚀 Starting Claude Code container...
+   🔧 Configuring Claude Code settings...
+   ✅ Claude Code configured with Z.AI API key
+   📋 Current settings.json:
+   ...
+   ```
+
+4. **Run Claude Code:**
+   ```bash
+   npm run claude:unsafe
+   ```
+
+5. **Verify configuration:**
+   Once inside Claude Code, run `/status` to check the current model in use.
+   You should see `glm-4.7` as the active model.
+
+## Switching Between Models
+
+### To switch from GLM-4.7 back to Anthropic Claude:
+
+1. Edit `.env` and set `ANTHROPIC_API_KEY` to your Anthropic key
+2. Remove or edit `.claude/settings.json` to remove the GLM model configuration
+3. Restart the container:
+   ```bash
+   npm run docker:down
+   npm run docker:up
+   ```
+
+### To customize model selection:
+
+Edit `./claude-data/settings.json` (created on first run) or `.claude/settings.json`:
+
+```json
+{
+  "env": {
+    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-3-5-haiku-20241022",
+    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-3-5-sonnet-20241022",
+    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-3-5-sonnet-20241022"
+  }
+}
+```
+
+## Available Commands
+
+| Command | Description |
+|---------|-------------|
+| `npm run docker:build` | Build Docker image |
+| `npm run docker:up` | Start container in background |
+| `npm run docker:down` | Stop and remove container |
+| `npm run docker:logs` | View container logs |
+| `npm run docker:shell` | Open bash shell in container |
+| `npm run claude` | Run Claude Code (normal mode) |
+| `npm run claude:unsafe` | Run Claude Code with --dangerously-skip-permissions |
+
+## Project Structure
+
+```
+.
+├── .docker/
+│   └── Dockerfile          # Docker image definition
+├── .claude/
+│   ├── settings.json       # Default GLM-4.7 model configuration
+│   └── agents/             # Default agent configurations
+│       ├── backend-node-pro.md
+│       ├── ui-architect.md
+│       ├── debugging-expert.md
+│       ├── architecture-reviewer.md
+│       └── technical-writer.md
+├── .env.example            # Environment variables template
+├── docker-compose.yml      # Docker Compose configuration
+├── package.json            # NPM scripts
+├── claude-data/            # Claude Code config (auto-created, overrides .claude/)
+└── README.md               # This file
+```
+
+## Default Agents
+
+The boilerplate includes pre-configured specialized agents:
+
+| Agent | Purpose | Model |
+|-------|---------|-------|
+| `backend-node-pro` | Backend Node.js development (API clients, workers, Firebase) | Opus/GLM-4.7 |
+| `ui-architect` | Frontend/React design (components, styling, UX) | Opus/GLM-4.7 |
+| `debugging-expert` | Debugging complex issues and root cause analysis | Opus/GLM-4.7 |
+| `architecture-reviewer` | System design evaluation and architectural decisions | Sonnet/GLM-4.7 |
+| `technical-writer` | Documentation, API references, guides | Sonnet/GLM-4.7 |
+
+## Configuration
+
+### Non-Root User
+
+The container runs as user `claude` (UID 2000) to satisfy Claude Code's security requirements when using `--dangerously-skip-permissions`.
+
+### Environment Variables
+
+Create a `.env` file from `.env.example`:
+
+```bash
+# Option 1: Anthropic Claude
+ANTHROPIC_API_KEY=sk-ant-xxxxx
+
+# Option 2: Z.AI GLM-4.7 (uses ZAI_API_KEY, overrides ANTHROPIC_API_KEY)
+ZAI_API_KEY=your-zai-api-key-here
+```
+
+### Default Configuration
+
+The container **automatically generates** `settings.json` on every startup using your API key from `.env`.
+
+- **API key injection**: The entrypoint script reads `ZAI_API_KEY` (or `ANTHROPIC_API_KEY`) and creates a properly configured `settings.json`
+- **Agents**: Pre-defined agent configurations from `.claude/agents/` are copied on first run
+- **Persistence**: Settings are stored in `./claude-data/` volume
+
+**Important:** Changes to `./claude-data/settings.json` will be overwritten on container restart. To persist custom settings, modify `.docker/entrypoint.sh`.
+
+### Git Integration
+
+Your host's `.gitconfig` is mounted read-only at `/home/claude/.gitconfig`, so commits in the container will be signed with your credentials.
+
+## Manual Docker Commands
+
+If you prefer running Docker commands directly:
+
+```bash
+# Build and start
+docker compose up -d --build
+
+# Enter container
+docker compose exec claude bash
+
+# Run claude directly
+docker compose exec claude claude --dangerously-skip-permissions
+
+# Stop
+docker compose down
+```
+
+## Tips
+
+1. **First setup**: Run `npm run docker:build && npm run docker:up` before first use
+2. **Persistent config**: Claude Code settings stored in `./claude-data/` (gitignore this)
+3. **Shared gitconfig**: Commits use your host's git identity
+4. **Workspace**: Project mounted at `/workspace` in container
+5. **GLM-4.7 users**: The default `settings.json` is pre-configured for GLM-4.7. Just set your Z.AI API key in `.env`
+6. **Reset config**: Delete `./claude-data/` and restart to revert to default configuration
+7. **Custom agents**: Add new `.md` files to `.claude/agents/` or `./claude-data/agents/` before building
+
+### Multi-line Prompts in Docker Container
+
+The `/terminal-setup` command doesn't work in Docker containers (detected as `xterm`). Use these alternatives:
+
+| Method | How to use |
+|--------|------------|
+| **Ctrl+J** | Press `Ctrl+J` to insert a new line (recommended) |
+| **Backslash** | Type `\` before pressing Enter to continue on next line |
+
+Example with backslash:
+```
+> This is line one\
+  and this continues on line two\
+  and line three
+```
+
+## Troubleshooting
+
+### GLM-4.7 Configuration Not Working
+
+1. **Check API key**: Ensure `ZAI_API_KEY` or `ANTHROPIC_API_KEY` is set in your `.env` file
+2. **Check container logs** to verify settings were generated:
+   ```bash
+   npm run docker:logs
+   # Should show: ✅ Claude Code configured with Z.AI API key
+   ```
+3. **Verify settings.json**: Run `/status` in Claude Code to see current model
+4. **Debug inside container**:
+   ```bash
+   npm run docker:shell
+   cat ~/.claude/settings.json
+   ```
+5. **Rebuild and restart** (if API key changed):
+   ```bash
+   npm run docker:down
+   npm run docker:up
+   ```
+
+### Permission Denied Errors
+
+The container runs as non-root user `claude` (UID 2000). If you encounter permission issues:
+
+1. **Check file ownership**: Ensure your project files are accessible by UID 2000
+2. **Adjust UID**: Modify the UID in Dockerfile if needed (currently 2000)
+
+## Project Structure
+
+```
+create-claude-docker/
+├── bin/
+│   └── create.js           # CLI entry point
+├── template/               # Boilerplate files copied to new projects
+│   ├── .docker/
+│   │   ├── Dockerfile
+│   │   └── entrypoint.sh
+│   ├── .claude/
+│   │   ├── settings.json
+│   │   └── agents/
+│   ├── .env.example
+│   ├── .gitignore
+│   ├── docker-compose.yml
+│   └── README.md
+├── package.json
+└── README.md
+```
+
+## Publishing to npm
+
+To publish this package to npm:
+
+```bash
+# Login to npm
+npm login
+
+# Update version
+npm version patch  # or minor, major
+
+# Publish
+npm publish
+```
+
+After publishing, users can create new projects with:
+
+```bash
+npx create-claude-docker my-awesome-project
+```
+
+## Development
+
+To test the CLI locally:
+
+```bash
+# From the repository root
+node bin/create.js test-project
+
+# Or link globally
+npm link
+create-claude-docker test-project
+```
+
+## License
+
+MIT

package/bin/create.js

@@ -0,0 +1,226 @@
+#!/usr/bin/env node
+
+/**
+ * create-claude-docker CLI
+ * Creates a new Claude Code Docker project from template
+ */
+
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+const { execSync } = require('child_process');
+
+// ANSI colors
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  green: '\x1b[32m',
+  cyan: '\x1b[36m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+  dim: '\x1b[2m',
+};
+
+const log = {
+  info: (msg) => console.log(`${colors.cyan}ℹ${colors.reset} ${msg}`),
+  success: (msg) => console.log(`${colors.green}✓${colors.reset} ${msg}`),
+  warn: (msg) => console.log(`${colors.yellow}⚠${colors.reset} ${msg}`),
+  error: (msg) => console.log(`${colors.red}✗${colors.reset} ${msg}`),
+  step: (msg) => console.log(`${colors.dim}  ${msg}${colors.reset}`),
+};
+
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout,
+});
+
+function ask(question, defaultValue = '') {
+  const defaultHint = defaultValue ? ` ${colors.dim}(${defaultValue})${colors.reset}` : '';
+  return new Promise((resolve) => {
+    rl.question(`${question}${defaultHint}: `, (answer) => {
+      resolve(answer.trim() || defaultValue);
+    });
+  });
+}
+
+function copyRecursive(src, dest, replacements = {}) {
+  const stats = fs.statSync(src);
+  
+  if (stats.isDirectory()) {
+    fs.mkdirSync(dest, { recursive: true });
+    const files = fs.readdirSync(src);
+    for (const file of files) {
+      copyRecursive(path.join(src, file), path.join(dest, file), replacements);
+    }
+  } else {
+    let content = fs.readFileSync(src, 'utf8');
+    
+    // Apply replacements for text files
+    if (!isBinaryFile(src)) {
+      for (const [key, value] of Object.entries(replacements)) {
+        content = content.replace(new RegExp(key, 'g'), value);
+      }
+    }
+    
+    fs.writeFileSync(dest, content);
+  }
+}
+
+function isBinaryFile(filePath) {
+  const binaryExtensions = ['.png', '.jpg', '.jpeg', '.gif', '.ico', '.woff', '.woff2', '.ttf', '.eot'];
+  return binaryExtensions.some(ext => filePath.endsWith(ext));
+}
+
+function toKebabCase(str) {
+  return str
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-|-$/g, '');
+}
+
+async function main() {
+  console.log(`
+${colors.bright}${colors.cyan}╔═══════════════════════════════════════════════════════════╗
+║           create-claude-docker                            ║
+║   Docker-based Claude Code development environment        ║
+╚═══════════════════════════════════════════════════════════╝${colors.reset}
+`);
+
+  // Get project name from args or prompt
+  let projectName = process.argv[2];
+  let description = '';
+  let author = '';
+
+  // Parse CLI arguments
+  const args = process.argv.slice(2);
+  const descIndex = args.findIndex(a => a === '--description' || a === '-d');
+  if (descIndex !== -1 && args[descIndex + 1]) {
+    description = args[descIndex + 1];
+    args.splice(descIndex, 2);
+  }
+  
+  const authorIndex = args.findIndex(a => a === '--author' || a === '-a');
+  if (authorIndex !== -1 && args[authorIndex + 1]) {
+    author = args[authorIndex + 1];
+    args.splice(authorIndex, 2);
+  }
+  
+  projectName = args[0];
+
+  // Interactive prompts if not provided
+  if (!projectName) {
+    projectName = await ask('Project name', 'my-claude-project');
+  }
+  
+  projectName = toKebabCase(projectName);
+  
+  if (!description) {
+    description = await ask('Description', 'A Claude Code Docker project');
+  }
+  
+  if (!author) {
+    try {
+      author = execSync('git config user.name', { encoding: 'utf8' }).trim();
+    } catch {
+      author = '';
+    }
+    author = await ask('Author', author);
+  }
+
+  rl.close();
+
+  const targetDir = path.resolve(process.cwd(), projectName);
+  const templateDir = path.join(__dirname, '..', 'template');
+
+  // Check if directory exists
+  if (fs.existsSync(targetDir)) {
+    log.error(`Directory "${projectName}" already exists!`);
+    process.exit(1);
+  }
+
+  console.log('');
+  log.info(`Creating project "${projectName}"...`);
+
+  // Create project directory
+  fs.mkdirSync(targetDir, { recursive: true });
+  log.step('Created project directory');
+
+  // Copy template files
+  copyRecursive(templateDir, targetDir);
+  log.step('Copied template files');
+
+  // Generate package.json
+  const packageJson = {
+    name: projectName,
+    version: '1.0.0',
+    description: description,
+    author: author,
+    scripts: {
+      'docker:build': 'docker compose build',
+      'docker:up': 'docker compose up -d',
+      'docker:down': 'docker compose down',
+      'docker:logs': 'docker compose logs -f',
+      'docker:shell': 'docker compose exec claude bash',
+      'claude': 'docker compose exec claude claude',
+      'claude:unsafe': 'docker compose exec claude claude --dangerously-skip-permissions',
+    },
+    keywords: ['claude-code', 'docker', 'anthropic', 'z-ai', 'glm-4'],
+  };
+
+  fs.writeFileSync(
+    path.join(targetDir, 'package.json'),
+    JSON.stringify(packageJson, null, 2) + '\n'
+  );
+  log.step('Generated package.json');
+
+  // Create .env from .env.example
+  const envExamplePath = path.join(targetDir, '.env.example');
+  const envPath = path.join(targetDir, '.env');
+  if (fs.existsSync(envExamplePath)) {
+    fs.copyFileSync(envExamplePath, envPath);
+    log.step('Created .env from .env.example');
+  }
+
+  // Rename gitignore.template to .gitignore (npm pack ignores .gitignore files)
+  const gitignoreTemplate = path.join(targetDir, 'gitignore.template');
+  const gitignorePath = path.join(targetDir, '.gitignore');
+  if (fs.existsSync(gitignoreTemplate)) {
+    fs.renameSync(gitignoreTemplate, gitignorePath);
+    log.step('Created .gitignore');
+  }
+
+  // Initialize git (optional)
+  try {
+    execSync('git init', { cwd: targetDir, stdio: 'ignore' });
+    execSync('git add .', { cwd: targetDir, stdio: 'ignore' });
+    log.step('Initialized git repository');
+  } catch {
+    log.warn('Could not initialize git repository');
+  }
+
+  console.log('');
+  log.success(`Project "${projectName}" created successfully!`);
+  
+  console.log(`
+${colors.bright}Next steps:${colors.reset}
+
+  ${colors.cyan}cd ${projectName}${colors.reset}
+  
+  ${colors.dim}# Add your Z.AI API key${colors.reset}
+  ${colors.cyan}nano .env${colors.reset}
+  
+  ${colors.dim}# Build and start the container${colors.reset}
+  ${colors.cyan}npm run docker:build${colors.reset}
+  ${colors.cyan}npm run docker:up${colors.reset}
+  
+  ${colors.dim}# Run Claude Code${colors.reset}
+  ${colors.cyan}npm run claude:unsafe${colors.reset}
+
+${colors.dim}Documentation: https://github.com/fishinthenet/create-claude-docker${colors.reset}
+`);
+}
+
+main().catch((err) => {
+  log.error(err.message);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "create-claude-docker",
+  "version": "1.0.1",
+  "description": "Create Docker-based Claude Code development environment with Z.AI GLM-4.7 support",
+  "author": "Szymon <szymon@fishinthenet.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fishinthenet/create-claude-docker.git"
+  },
+  "bugs": {
+    "url": "https://github.com/fishinthenet/create-claude-docker/issues"
+  },
+  "homepage": "https://github.com/fishinthenet/create-claude-docker#readme",
+  "bin": {
+    "create-claude-docker": "./bin/create.js"
+  },
+  "files": [
+    "bin",
+    "template"
+  ],
+  "keywords": [
+    "claude-code",
+    "docker",
+    "anthropic",
+    "z-ai",
+    "glm-4",
+    "boilerplate",
+    "create",
+    "cli"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "docker:build": "docker compose build",
+    "docker:up": "docker compose up -d",
+    "docker:down": "docker compose down",
+    "docker:logs": "docker compose logs -f",
+    "docker:shell": "docker compose exec claude bash",
+    "claude": "docker compose exec claude claude",
+    "claude:unsafe": "docker compose exec claude claude --dangerously-skip-permissions",
+    "test": "node bin/create.js --help"
+  }
+}