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