StackPanel

stackpanel init

Initialize a new stackpanel project

stackpanel init

Initialize creates the .stack directory structure with boilerplate files.

This command evaluates the stackpanel flake to get the list of files to create, then writes them to the appropriate locations. Existing files are NOT overwritten unless --force is specified.

The initialized structure includes:

  • .stack/config.nix User-editable configuration file
  • .stack/_internal.nix Internal merging logic (do not edit)
  • .stack/data.nix Agent-editable data file
  • .stack/.gitignore Gitignore for state and local config

Example: stackpanel init # Create files in current directory stackpanel init --force # Overwrite existing files stackpanel init --dry-run # Show what would be created stackpanel init --flake path:/path/to/sp # Use local stackpanel for development

Usage

stackpanel init

Flags

FlagTypeDefaultDescription
--dry-runboolfalseShow what would be created without writing files
--flakestringnoneStackpanel flake reference (default: github:darkmatter/stackpanel)
--forceboolfalseOverwrite existing files

Global Flags

These flags are inherited from parent commands.

FlagTypeDefaultDescription
--daemon, -dboolfalseRun in daemon mode (no TUI, for background processes)
--no-colorboolfalseDisable color output
--no-tuiboolfalseDisable interactive TUI mode
--verbose, -vboolfalseEnable verbose output

On this page