Install Speck CLI globally via symlink to ~/.local/bin/speck
Initialize Speck in the current repository, create the `.speck/` directory structure, configure permissions, and install the CLI globally via symlink. Use this when setting up Speck for the first time in a project.
/plugin marketplace add nprbst/speck-market/plugin install nprbst-speck-speck@nprbst/speck-market$ARGUMENTS
You MUST consider the user input before proceeding (if not empty).
This command initializes Speck in the current repository and optionally installs the CLI globally.
.speck/ directory in the current repository with:
memory/ - For constitution.md and other memory filesscripts/ - For custom scripts.speck/config.json with user preferences for worktree mode and IDE settings.claude/settings.local.json to allow reading from Speck's template files without prompts (this file is gitignored)~/.local/bin/speck/speck:constitution if neededBefore running speck init, ask the user about their preferences:
Worktree Mode (default: enabled)
--worktree-enabled false--worktree-enabled trueIDE Auto-Launch (default: disabled)
--ide-autolaunch true and proceed to ask which IDEIDE Editor (only if auto-launch enabled)
After collecting user preferences, run:
speck init [FLAGS]
If the command fails (speck not found in PATH), fall back to running via bun in a separate Bash call:
bun $HOME/.claude/plugins/marketplaces/speck-market/speck/dist/speck-cli.js init [FLAGS]
Replace [FLAGS] with the appropriate flags based on user responses:
--worktree-enabled true or --worktree-enabled false--ide-autolaunch true (if enabled)--ide-editor <choice> (if IDE auto-launch is enabled)Example with all options:
speck init --worktree-enabled true --ide-autolaunch true --ide-editor cursor
Example with defaults (worktree enabled, no IDE auto-launch):
speck init --worktree-enabled true
--force: Force reinstall even if symlink already exists--json: Output result as JSON--worktree-enabled <true|false>: Enable or disable worktree mode--ide-autolaunch <true|false>: Enable or disable IDE auto-launch--ide-editor <editor>: IDE editor choice (vscode/cursor/webstorm/idea/pycharm)If ~/.local/bin is not in your PATH, add this to your shell config:
For bash (~/.bashrc) or zsh (~/.zshrc):
export PATH="$HOME/.local/bin:$PATH"
Then reload: source ~/.bashrc or source ~/.zshrc
After initialization completes successfully:
/speck:constitution to define your project principlesImportant: The permission configuration in .claude/settings.local.json requires a Claude Code restart to take effect. Without restarting, you may still see permission prompts when reading template files.
$ARGUMENTS