SUPERSET DEVELOPERS

# Introducing Claudette CLI: Supercharge Superset Development

Maxime Beauchemin, Evan Rusackas

August 28, 2025

3 min read

481 words

**TL;DR**: Tired of juggling multiple Superset environments and waiting for containers to restart every time you switch branches? Meet Claudette CLI, a 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 using Git worktrees to create completely isolated development environments for each project or branch. You end up with 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](https://github.com/mistercrunch/claudette-cli)**

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.

---

**Related Reading**

- [How Micro-Corrections Drive AI Success](https://preset.io/blog/how-micro-corrections-drive-ai/): Why intuition and small nudges matter more than perfect prompts
- [Adopting Claude Code: Riding the Software Economics Singularity](https://preset.io/blog/adopting-claude-code-riding-the-software-economics-singularity/): The broader transformation in software development economics
- [How to Contribute to Superset](https://preset.io/blog/how-to-contribute-to-superset/): Getting started as a Superset contributor

## Let's get visual. Try Preset today. [Start for free](https://manage.app.preset.io/starter-registration/)

#### Subscribe to our blog updates

Receive a weekly digest of new blog posts