CLI Reference

fiber start

Start the Fiberwiseweb server with production or development mode.

fiber start [OPTIONS]

Options

Examples

# Production mode with built assets
fiber start

# Development mode with Vite dev server
fiber start --dev

# Production mode with background worker
fiber start --worker

# Development mode with worker and Vite
fiber start --dev --worker

# Custom port
fiber start --port 3000

# Custom ports for both servers
fiber start --dev --port 3000 --vite-port 3001

fiber setup

Initialize Fiberwisedatabase, storage configuration, and web components. This is required before using any other Fiberwisefeatures.

fiber setup [OPTIONS]

Options

What Initialize Does

1. Database Setup
   • Creates SQLite database at ~/.fiberwise/fiberwise.db
   • Applies all database migrations
   • Creates default admin user ([email protected])
   • Sets up CLI application configuration
2. Storage Configuration
   • Creates ~/.fiberwise directory structure
   • Sets up local storage provider (default)
   • Configures app bundles directory
   • Creates agent storage directories
3. Web Components
   • Clones fiberwise-core-web repository (if not present)
   • Installs Node.js dependencies with npm
   • Builds Vite frontend assets
   • Sets up both simple and advanced web interfaces

Examples

# Basic setup
fiber setup

# With verbose output to see progress
fiber setup --verbose

# Force re-setup (WARNING: loses data)
fiber setup --force

# Use PostgreSQL database
fiber setup --database-url postgresql://user:pass@localhost/fiberwise

Verification

# Check if setup was successful
fiber start --help

# Look for the database file
ls -la ~/.fiberwise/

🔐 fiber account

Manage Fiberwise account configurations for connecting to different environments.

fiber account add-config [OPTIONS]

# Add production configuration
fiber account add-config \
  --name "production" \
  --api-key "fw_1234567890abcdef1234567890abcdef" \
  --base-url "https://api.fiberwise.ai" \
  --set-default

# Add local development configuration
fiber account add-config \
  --name "local-dev" \
  --api-key "fw_dev_key_here" \
  --base-url "http://localhost:5555"

fiber account list-configs

Available configurations:
* production (https://api.fiberwise.ai) [DEFAULT]
  local-dev (http://localhost:5555)

fiber account login [OPTIONS]

fiber account add-provider [OPTIONS]

# Add OpenAI provider
fiber account add-provider \
  --provider openai \
  --api-key "sk-..." \
  --name "My OpenAI"

# Add Anthropic Claude provider
fiber account add-provider \
  --provider anthropic \
  --api-key "sk-ant-..." \
  --name "Claude Production"

fiber activate

Activate a Fiberwiseagent by file path.

fiber activate [OPTIONS] FILE_PATH

Arguments

Options

Examples

# Basic activation (runs on local instance)
fiber activate ./my_agent.py

# Run on your default configured server
fiber activate --to-instance default ./my_agent.py

# Run on production server with input data
fiber activate --to-instance production --input-data '{"query": "test"}' ./my_agent.py

# With version and verbose output
fiber activate --verbose --version "2.0.0" --input-data '{"key": "value"}' ./agent.py

# Run on staging with verbose output
fiber activate --to-instance staging --verbose ./my_agent.py

fiber functions

Function and pipeline management commands that work directly with local services.

fiber functions [COMMAND] [OPTIONS]

Subcommands

fiber functions list

List all functions in the system.

fiber functions list [OPTIONS]

fiber functions show

Show detailed information about a function.

fiber functions show <function_id> [OPTIONS]

fiber functions create

Create a new function from a Python file.

fiber functions create <name> [OPTIONS]

fiber functions execute

Execute a function with optional input data.

fiber functions execute <function_id> [OPTIONS]

fiber functions list-pipelines

List all pipelines in the system.

fiber functions list-pipelines [OPTIONS]

fiber functions execute-pipeline

Execute a pipeline with optional input data.

fiber functions execute-pipeline <pipeline_id> [OPTIONS]

fiber functions pipeline-status

Check the status of a pipeline execution.

fiber functions pipeline-status <execution_id> [OPTIONS]

Examples

# List all functions
fiber functions list

# Search for utility functions
fiber functions list --search "process" --type utility --verbose

# Show detailed function information
fiber functions show hello_world --verbose

# Create a new function from a Python file
fiber functions create my_function \
  --description "Processes data" \
  --type transform \
  --file ./my_function.py \
  --verbose

# Execute a function with JSON input
fiber functions execute my_function \
  --input-data '{"name": "FIberwise", "data": [1,2,3]}' \
  --verbose

# List all pipelines
fiber functions list-pipelines --verbose

# Execute a pipeline
fiber functions execute-pipeline my-pipeline-id \
  --input-data '{"source": "api"}' \
  --verbose

# Check pipeline execution status
fiber functions pipeline-status execution-uuid --verbose

fiber worker

Start a worker to process agent activations.

fiber worker [OPTIONS]

Options

fiber list-agents

List all registered agents.

fiber list-agents [OPTIONS]

Options

fiber account

Manage Fiberwiseaccount configurations.

fiber account [COMMAND] [OPTIONS]

Subcommands

fiber account login

Log in using a configuration file.

fiber account login --config /path/to/config.json

fiber account add-config

Add a new configuration directly from command-line options.

fiber account add-config --name "production" --api-key "your-api-key" --base-url "https://api.fiberwise.ai" --set-default

fiber account list-configs

List all saved configurations.

fiber account list-configs

fiber account import-providers

Import model providers information from the specified app ID.

fiber account import-providers --app-id app-123xyz --save-to-file --format detailed

fiber account list-authenticators

List saved model providers.

fiber account list-authenticators --format detailed

fiber account add-provider

Add a new LLM provider with API key directly to the database.

fiber account add-provider --provider openai --api-key YOUR_KEY --model gpt-4 --set-default

fiber account provider

Manage model providers with subcommands:

• fiber account provider list - List providers by type
• fiber account provider default "Provider Name" - Set default provider

fiber account oauth

Manage OAuth authenticators and connections:

• fiber account oauth configure AUTHENTICATOR_ID - Configure OAuth authenticator
• fiber account oauth list-authenticators - List configured OAuth authenticators
• fiber account oauth auth AUTHENTICATOR_ID - Start OAuth authentication flow
• fiber account oauth list-connections - List OAuth connections
• fiber account oauth revoke AUTHENTICATOR_ID - Revoke OAuth connection

🚀 fiber app

Modern application management with clean architecture and proper instance routing. UPDATED

fiber app [COMMAND] [OPTIONS]

Core Commands

fiber app install [APP_PATH] [OPTIONS]

# Install from current directory
fiber app install

# Install with verbose output (recommended)
fiber app install . --verbose

# Install from specific directory to production instance
fiber app install /path/to/my-app --to-instance production --verbose

# Install with custom manifest file
fiber app install --manifest custom_manifest.yaml --verbose

# Install to specific configuration profile
fiber app install --config development --verbose

fiber app update [APP_PATH] [OPTIONS]

# Smart update (only if changes detected)
fiber app update

# Force update regardless of changes
fiber app update --force --verbose

# Update specific directory to production
fiber app update /path/to/my-app --to-instance production --verbose

# Update with different manifest file
fiber app update --manifest updated_manifest.yaml --force

# 1. Initial Installation
fiber app install ./my-app --verbose

# 2. Development changes
# Edit files, update manifest version, modify agents...

# 3. Smart update (recommended)
fiber app update ./my-app --verbose

# 4. Verification
fiber activate ./my-app/agents/my_agent.py --input-data '{"test": true}'

# 1. Test in development first
fiber app update ./my-app --to-instance dev --verbose

# 2. Deploy to production with explicit versioning
fiber app update ./my-app --to-instance prod --force --verbose

# 3. Rollback if needed (revert manifest, then update)
git checkout HEAD~1 -- app_manifest.yaml
fiber app update ./my-app --to-instance prod --force

# Update across environments with confirmation
for env in dev staging prod; do
  echo "Updating $env environment..."
  fiber app update ./my-app --to-instance "$env" --verbose
  echo "Press Enter to continue to next environment..."
  read
done

fiber app oauth register-authenticator [OPTIONS]

{
  "name": "My Google OAuth",
  "provider_type": "google",
  "client_id": "your-google-client-id",
  "client_secret": "your-google-client-secret",
  "scopes": ["profile", "email"],
  "redirect_uri": "https://your-app.com/oauth/callback"
}

# Register Google OAuth authenticator
fiber app oauth register-authenticator \
  --authenticator-config ./oauth/google.json \
  --config-name production

# Register with app in different directory
fiber app oauth register-authenticator \
  --authenticator-config ./oauth/github.json \
  --app-dir /path/to/my-app

fiber app oauth list-authenticators [OPTIONS]

fiber app oauth delete-authenticator [AUTHENTICATOR_ID] [OPTIONS]

# Set up development configuration
fiber account add-config \
  --name "dev" \
  --api-key "fw_dev_key" \
  --base-url "http://localhost:8000" \
  --set-default

# Install app for development
fiber app install . --verbose

# Make changes and update
# (Smart detection will skip if no changes)
fiber app update --verbose

# Force update after significant changes
fiber app update --force --verbose

# Install to staging
fiber app install . --to-instance staging --verbose

# Test and validate...

# Deploy to production
fiber app install . --to-instance production --verbose

# Configure OAuth for production
fiber app oauth register-authenticator \
  --authenticator-config ./oauth/prod-google.json \
  --config-name production

fiber bundle

Bundle management commands.

fiber bundle [COMMAND] [OPTIONS]

Subcommands

fiber bundle create

Bundle a Fiberwiseapplication based on its manifest.

fiber bundle create --app-dir /path/to/app --env prod --verbose

Options

fiber install

Install Fiberwise applications with automatic build and deployment. This command handles the complete app installation process including building, bundling, and deployment.

fiber install app [DIRECTORY] [OPTIONS]

Primary Usage: App Installation

fiber install app

Install a Fiberwiseapplication from the current directory or specified path. Includes automatic npm build, bundle creation, and deployment.

# Install app from current directory (most common)
fiber install app .

# Install with verbose output (recommended)
fiber install app . --verbose

# Install from specific directory
fiber install app /path/to/my-app --verbose

# Skip automatic build (if already built)
fiber install app . --no-build --verbose

Options

Installation Process

When you run fiber install app, the system automatically:

1. Dependency Installation: Runs npm install if needed
2. Build Process: Executes npm run build (unless --no-build)
3. Bundle Creation: Creates zip archive from dist/ directory
4. Manifest Processing: Validates and processes app manifest
5. Upload & Deployment: Uploads bundle to platform
6. Route Registration: Registers app routes with router
7. Cleanup: Removes temporary installation files

# Check current app state
cat .fw-data/fw_app_info.json

# Force update with full logging
fiber app update --force --verbose

# Test API connection
curl -H "Authorization: Bearer api_your-key" \
  http://localhost:6701/api/v1/health

# Validate manifest syntax
python -c "import yaml; print(yaml.safe_load(open('app_manifest.yaml')))"

Example Workflow

# Navigate to your app directory
cd my-fiberwise-app

# Clean up any old bundles
rm -f *.zip

# Install the app with verbose output
fiber install app . --verbose

# App will be available at:
# http://localhost:8000/apps/your-app-name

fiber seed-user

Create a seed user for FIberwise.

fiber seed-user [OPTIONS]

Options

Default Credentials (Development)

fiber seed-system-user

Create a seed system user based on the current system user.

fiber seed-system-user --force