All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
- Alpine images: tsx failed at runtime due to missing esbuild dependency (cherry-picked binaries instead of copying full
/usr/local/bin/)
scripts/test-variants.sh- Repeatable test suite that builds and validates all 4 Docker image variants
- BREAKING: Migrated from Claude Code SDK to Claude Agents SDK
- npm:
@anthropic-ai/claude-code→@anthropic-ai/claude-agent-sdk - pip:
claude-code-sdk→claude-agent-sdk - Python imports:
claude_code_sdk→claude_agent_sdk ClaudeCodeOptions→ClaudeAgentOptions
- npm:
- Updated all Dockerfiles, examples, tests, and CI/CD workflows
- Updated versions.json schema for new package names
- Automated version update system - Daily checks for new SDK releases
- Updated to latest SDK versions:
- Claude Code CLI: v1.0.64
- Python SDK: v0.0.17
- Added version documentation comments to all Dockerfiles
- Subagent scaffolding with example configurations from official documentation
code-reviewer: Expert code review specialist for quality and securitydebugger: Debugging specialist for root cause analysisdata-scientist: Data analysis expert for SQL and BigQuery operations
- Complete
.claude/agents/directory structure for custom subagent definitions
- Enhanced Claude Code configuration scaffolding with agents support
- Alpine Linux variants for minimal container deployments
- Alpine TypeScript image (383MB) - 47% smaller than Debian
- Alpine Python image (474MB) - 32% smaller than Debian
- Intelligent conditional builds using paths-filter to optimize CI usage
- Multi-stage Docker builds for all variants
- Significant size reductions across all container variants:
- Debian TypeScript: 727MB → 607MB (16% reduction)
- Debian Python: 813MB → 693MB (15% reduction)
- Binary cleanup optimization removes unused platform-specific files
- Improved GitHub Actions workflow with selective builds based on file changes
- Alpine container permissions issue with entrypoint script
- Path-based filtering logic for conditional CI builds
- Proper authentication handling in Alpine environments
- Initial release of Claude Code SDK Docker containers
- TypeScript base image (727MB) with Claude Code CLI and SDK
- Python extension image (813MB) with claude-code-sdk-python
- Long-lived OAuth token authentication support
- Multi-stage Docker builds for optimized image sizes
- Example code for JavaScript, TypeScript, and Python
- Docker Compose configurations for easy local development
- GitHub Actions workflow for automated builds and publishing
- Non-root user security implementation
- Claude CLI configuration scaffolding (.claude directory)
- Containers run as non-root user
claude - Proper file permissions for authentication files
- No secrets embedded in images
- Comprehensive README with quick start guide
- Authentication guide for different auth methods
- Examples directory with working code samples
- API key authentication not fully tested