devlaunch 0.0.1

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 <workspace>               # Start workspace and attach shell
dl <workspace> <command>     # Run command in workspace
dl owner/repo                # Create workspace from GitHub repo
dl owner/repo@branch         # Create workspace from specific branch
dl ./path                    # Create workspace from local path

Commands

Command	Description
dl --ls	List all workspaces
dl --stop <workspace>	Stop a workspace
dl --rm <workspace>	Delete a workspace
dl --code <workspace>	Open workspace in VS Code
dl --status <workspace>	Show workspace status
dl --recreate <workspace>	Recreate workspace container
dl --reset <workspace>	Reset workspace (clean slate)
dl --install	Install shell completions
dl --help	Show help

Examples

# Select workspace interactively with fzf
dl

# Open an existing workspace
dl myproject

# Create workspace from GitHub repository
dl loft-sh/devpod

# Create workspace from specific branch
dl blooop/devlaunch@main

# Create workspace from local folder
dl ./my-project

# Open workspace in VS Code
dl --code myproject

# Run a command in workspace
dl myproject 'make test'

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 command flags (--ls, --stop, etc.)

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