paw-tools-setup

Pawbytes Tools Setup

Overview

Installs and configures Pawbytes Tools module into a project. Collects user preferences and writes them to:

• {project-root}/.pawbytes/config/config.yaml — shared Pawbytes ecosystem configuration
• {project-root}/.pawbytes/config/config.user.yaml — personal settings (gitignored, contains API keys)

{project-root} is a literal token in config values — never substitute it with an actual path. It signals to the consuming LLM that the value is relative to the project root.

On Activation

1. Read ./assets/module.yaml for module metadata and variable definitions
2. Check if {project-root}/.pawbytes/config/config.yaml exists — if present, inform the user this is an update

If the user provides arguments (e.g. accept all defaults, --headless, or inline values), map provided values to config keys, use defaults for the rest, and skip interactive prompting.

Collect Configuration

Ask the user for values. Show defaults in brackets. Present all values together so the user can respond once with only the values they want to change (e.g. "change language to Swahili, rest are fine"). Never tell the user to "press enter" or "leave blank" — in a chat interface they must type something to respond.

Default priority (highest wins): existing config values > ./assets/module.yaml defaults.

Module config: Read each variable in ./assets/module.yaml that has a prompt field. Ask using that prompt with its default value (or existing value if available).

Write Files

Write the collected configuration to:

{project-root}/.pawbytes/config/config.yaml

User-specific settings (API keys) go to:

{project-root}/.pawbytes/config/config.user.yaml

Create directories if they don't exist.

Create Output Directories

After writing config, create any output directories that were configured. Resolve the {project-root} token to the actual project root and create each path-type value that does not yet exist. Use mkdir -p or equivalent.

Confirm

Display what was written — config values set, fresh install vs update. Then display the greeting from ./assets/module.yaml to the user.

Outcome

Once the user's communication_language is known (from collected input, arguments, or existing config), use it consistently for the remainder of the session.