Introducing Claudette CLI: Supercharge Your Apache Superset Development

TL;DR: Tired of juggling multiple Superset environments and waiting for containers to restart every time you switch branches? Meet Claudette CLI—a game-changing tool that lets you run multiple isolated Superset environments simultaneously, built for the AI-assisted development era.

Overview: See Claudette In Action

The Problem: Environment Hell

If you've ever worked on Apache Superset development, you know the pain. Switching between feature branches means:

• Rebuilding Docker containers (again)
• Reinstalling npm dependencies (again)
• Dealing with Python virtual environment conflicts
• Port collisions when trying to run multiple instances
• Lost context and broken workflows

In today's AI-assisted development world, where Claude Code and other AI tools can generate code rapidly, these environment bottlenecks have become the new limiting factor. You're no longer waiting for code to be written—you're waiting for environments to spin up.

The Solution: Claudette CLI

Claudette CLI transforms how you work with Superset by leveraging Git worktrees to create completely isolated development environments for each project or branch. Think of it as having multiple Superset installations that share the same Git history but run independently.

Key Features

🌳 Git Worktree Magic: Each project gets its own directory with isolated Python virtual environments and node_modules, while sharing the underlying Git repository.

🐳 Docker Integration: Run multiple Superset instances on different ports simultaneously—no more container conflicts.

⚡ Lightning Setup: New projects spin up in seconds with automatic dependency installation using uv for Python packages.

🧊 Smart Resource Management: Freeze inactive projects to reclaim ~3GB of disk space per environment, then thaw them instantly when needed.

🤖 Claude Code Ready: Built-in integration with Claude Code for seamless AI-assisted development workflows.

📝 Project Documentation: Persistent PROJECT.md files that survive branch switching and provide context to AI assistants.

Quick Start

Getting started takes less than a minute:

# Install claudette
pip install git+https://github.com/mistercrunch/claudette-cli.git

# Initialize (clones Superset and sets up base config)
claudette init

# Create your first isolated project
clo add my-feature

# Drop into a Docker container and start coding
clo shell

Pro tip: Use clo as the shorter alias for all commands!

Real-World Impact

The benefits become immediately apparent:

• Parallel Development: Work on multiple features simultaneously without environment conflicts
• Zero Context Switching Cost: Each environment maintains its state—databases, configurations, and dependencies
• AI-Optimized Workflow: Spend time coding with AI assistance instead of waiting for environments
• Resource Efficient: Freeze unused projects to keep your machine lean

Perfect For

• Superset Contributors: Manage multiple PRs effortlessly
• Data Teams: Test features across different branches simultaneously
• AI-Assisted Developers: Eliminate environment setup bottlenecks
• Anyone juggling multiple Superset projects

Commands You'll Love

clo add feature-x        # Create new isolated environment
clo shell               # Enter Docker container  
clo docker up           # Start services
clo claude code         # Launch Claude with project context
clo pytest tests/       # Run tests in isolation
clo freeze old-feature  # Save 3GB+ disk space
clo list                # See all your projects

Get Started Today

Ready to transform your Superset development workflow?
➡️ Get Claudette CLI on GitHub

The tool is open source and actively maintained. Contributions, feedback, and feature requests are welcome!

All the features of Superset (and more) without the hassles of scaling/managing/upgrading, with plenty of time to grow into it. Free for five users, forever.