serve
Start the Weavr server with the web UI and API.
node weavr.mjs serve [options]
Options
| Option | Description | Default |
|---|---|---|
| --port | Port to listen on | 3847 |
| --host | Host to bind to | localhost |
Examples
# Start with defaults
node weavr.mjs serve
# Custom port
node weavr.mjs serve --port 8080
# Bind to all interfaces (for remote access)
node weavr.mjs serve --host 0.0.0.0
run
Execute a workflow by name.
node weavr.mjs run <workflow-name> [options]
Options
| Option | Description |
|---|---|
| --input, -i | JSON input data for the workflow |
| --verbose, -v | Show detailed execution output |
Examples
# Run a workflow
node weavr.mjs run hello-world
# Run with input data
node weavr.mjs run process-data -i '{"file": "data.csv"}'
# Verbose output
node weavr.mjs run my-workflow --verbose
list
List all available workflows.
node weavr.mjs list
Displays workflows from ~/.weavr/workflows/ with their names and descriptions.
create
Create a new workflow from a template.
node weavr.mjs create [options]
Options
| Option | Description |
|---|---|
| --name | Workflow name |
| --description | Workflow description |
| --trigger | Trigger type (manual, cron, webhook, etc.) |
| --non-interactive | Skip prompts, use flags only |
Examples
# Interactive mode
node weavr.mjs create
# Non-interactive
node weavr.mjs create --non-interactive \
--name my-workflow \
--description "Process daily reports" \
--trigger cron
ask
Generate a workflow using AI from a natural language description.
node weavr.mjs ask "<description>" [options]
Options
| Option | Description |
|---|---|
| --output, -o | Save generated workflow to file |
| --non-interactive | Skip confirmation prompts |
Examples
# Generate and review interactively
node weavr.mjs ask "Create a workflow that backs up my database daily"
# Generate and save directly
node weavr.mjs ask "Monitor a URL and alert on errors" \
--non-interactive \
--output ~/.weavr/workflows/url-monitor.yaml
Requires AI provider: Configure an Anthropic or OpenAI API key in your config.
onboard
Initial setup and configuration wizard.
node weavr.mjs onboard [options]
Options
| Option | Description |
|---|---|
| --non-interactive | Skip prompts, use flags only |
| --ai-provider | AI provider (anthropic, openai, none) |
| --skip-web-search | Skip web search API setup |
Examples
# Interactive setup
node weavr.mjs onboard
# Non-interactive for CI/scripts
node weavr.mjs onboard --non-interactive --ai-provider anthropic
doctor
Check your Weavr installation and configuration.
node weavr.mjs doctor
Checks for:
- Node.js version compatibility
- Configuration file presence and validity
- API key configuration
- Plugin availability