[kerdofficial]

Summary

This release adds template-based project creation, an interactive configuration menu, richer workspace management, and multiple usability improvements across the CLI.

What's new

Project Constructor: wd new

wd can now create new projects from templates.

Added

• New command: wd new [app-name]
• Interactive project creation flow
• Template selection, variant selection, and package manager selection
• Support for template-specific extra options
• Local custom templates from ~/.config/wd/templates/*.json
• Cached remote templates with offline fallback
• Automatic cd into the new project after successful creation

New flags

• --template, -t
• --variant, -v
• --pm, --package-manager
• --dir
• --dry-run
• --verbose
• --raw

Behavior improvements

• --dry-run previews the generated create command without creating files
• Unknown flags are warned about and ignored
• Variant-incompatible dynamic flags are warned about and ignored
• Existing target directories require confirmation before continuing
• Missing target directories can be created from inside the flow
• New projects are automatically added to frecency history

Interactive configuration: wd config

wd now includes a built-in interactive configuration menu.

Added

• New command: wd config
• Interactive management for:
  • scan roots
  • custom project types
  • show project type badge
  • show category
  • max recent projects
  • scan ignore list
  • templates URL

Improvements

• Scan roots can now be managed without rerunning setup
• Custom project types can be added, edited, and removed interactively
• Template source URL can be tested and changed from the CLI

Workspace improvements

Workspace flows are now more flexible and easier to use.

Added

• wd ws without arguments now opens an interactive workspace browser
• New command: wd ws duplicate <name>

Workspace browser

• Browse saved workspaces interactively
• Open, edit, duplicate, or delete a workspace from the menu
• Quick-open shortcut directly from the workspace list

Workspace duplication

• Duplicate an existing workspace under a new name
• Automatic duplicate name suggestions like name-duplicate, name-duplicate-2, etc.

Other workspace improvements

• Stronger workspace name validation
• Better handling of duplicate workspace names
• Improved rename flow during workspace editing
• Better compose-file suggestions when editing workspaces

Setup and usability improvements

Updated wd setup

• Can show and remove existing scan roots
• Installs the shell integration script into the config directory
• Offers an initial project scan
• Initializes the templates directory with an example hidden template

CLI improvements

• Better errors for unknown commands
• Better errors for unknown workspace subcommands
• Improved validation and error messages across workspace and project creation flows

Documentation

Added documentation for:

• wd new
• wd config
• interactive wd ws
• wd ws duplicate
• new flags and updated setup/config behavior

Notes

• The Project Constructor is currently marked as beta in the CLI.