Skip to main content

Synopsis

profclaw init [directory] [flags]

Description

init creates the directory structure and default configuration files needed to run profClaw. It is a lightweight alternative to profclaw onboard for cases where you want to manage configuration manually or integrate with an existing setup script. For a guided first-time setup with environment detection, AI provider configuration, and admin account creation, use profclaw onboard instead.

Arguments

directory
string
default:"."
Directory to initialize. Defaults to the current directory. Created if it does not exist.

Flags

--mode
string
default:"mini"
Deployment mode to write into the generated config: pico, mini, or pro.
--force
boolean
Overwrite existing configuration files. By default, init skips files that already exist.
--no-env
boolean
Skip creating the .env template file.

Files Created

config/
  settings.yml    # Core server configuration
  agents.yml      # Agent configuration
  cron.yml        # Scheduled jobs (empty)
  pricing.yml     # Model pricing overrides
skills/           # Skills directory (empty)
data/             # Database directory (empty, created on first run)
.env.example      # Environment variable template

Examples

profclaw init

After Initializing

# Copy and edit the env template
cp .env.example .env
# Add your API keys and configuration

# Run the interactive setup wizard
profclaw onboard

# Or start directly if already configured
profclaw serve