devlaunch 0.0.4

DevLaunch - A streamlined CLI for devpod workspaces

devlaunch

A streamlined CLI for devpod with intuitive autocomplete and fzf fuzzy selection.

Continuous Integration Status

Installation

# Using pixi (recommended)
pixi global install devlaunch

# Using pip
pip install devlaunch

After installation, set up shell completions:

dl --install
source ~/.bashrc  # or restart your terminal

Usage

dl                               # Interactive workspace selector (fzf)
dl <user/repo>                   # Start workspace and attach shell
dl <user/repo> <cmd>             # Run workspace command (stop, code, etc.)
dl <user/repo> -- <command>      # Run shell command in workspace

Workspace Sources

dl myproject                     # Existing workspace by name
dl user/repo                     # Create from GitHub repo
dl user/repo@branch              # Create from specific branch
dl ./path                        # Create from local path

Workspace Commands

Command	Description
dl <user/repo> stop	Stop the workspace
dl <user/repo> rm, prune	Delete the workspace
dl <user/repo> code	Open in VS Code
dl <user/repo> restart	Stop and start (no rebuild)
dl <user/repo> recreate	Recreate container
dl <user/repo> reset	Clean slate (remove all, recreate)
dl <user/repo> -- <command>	Run shell command in workspace

Global Commands

Command	Description
dl --ls	List all workspaces
dl --install	Install shell completions
dl --help, -h	Show this help
dl --version	Show version

Examples

dl                               # Select workspace with fzf
dl devpod                        # Open existing workspace
dl loft-sh/devpod                # Create from GitHub
dl blooop/devlaunch@main         # Create from specific branch
dl ./my-project                  # Create from local folder
dl blooop/devlaunch code         # Open in VS Code
dl blooop/devlaunch -- make test # Run command in workspace
dl blooop/devlaunch stop         # Stop workspace

Features

• Fuzzy Selection: When called without arguments, uses fzf for interactive workspace selection
• Smart Completion: Tab completion for workspaces, GitHub repos (owner/repo format), and paths
• GitHub Shorthand: Use owner/repo instead of full URLs - automatically expands to github.com/owner/repo
• Branch Support: Specify branches with owner/repo@branch syntax
• Fast Autocomplete: Completion cache for ~3ms response time (vs ~700ms without cache)

Shell Completion

After running dl --install, you get intelligent tab completion:

• Workspace names from your devpod list
• Known GitHub owners and repositories from your workspaces
• File/directory paths when starting with ./, /, or ~
• All global flags (--ls, --install, etc.) and workspace commands

Development

This project uses pixi for environment management.

# Run tests
pixi run test

# Run full CI suite
pixi run ci

# Format and lint
pixi run style