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 initFlags
| Flag | Type | Default | Description |
|---|---|---|---|
--dry-run | bool | false | Show what would be created without writing files |
--flake | string | none | Stackpanel flake reference (default: github:darkmatter/stackpanel) |
--force | bool | false | Overwrite existing files |
Global Flags
These flags are inherited from parent commands.
| Flag | Type | Default | Description |
|---|---|---|---|
--daemon, -d | bool | false | Run in daemon mode (no TUI, for background processes) |
--no-color | bool | false | Disable color output |
--no-tui | bool | false | Disable interactive TUI mode |
--verbose, -v | bool | false | Enable verbose output |