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
- Read
./assets/module.yamlfor module metadata and variable definitions - Check if
{project-root}/.pawbytes/config/config.yamlexists — 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.yamlUser-specific settings (API keys) go to:
{project-root}/.pawbytes/config/config.user.yamlCreate 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.