Skip to main content

​
Overview

The Local Machine integration allows your workflows to control your local computer directly - execute commands, manage files, take screenshots, send notifications, and more. Perfect for personal automation and desktop integration.

File Operations

Read, write, and manage files

Command Execution

Run shell commands locally

Computer Use

Control desktop, take screenshots

Notifications

Send system notifications and messages

​
Setup

​
Installing the Connector

  1. Download the Splox Local Connector for your OS:
  2. Install and launch the connector
  3. Sign in with your Splox account
  4. The connector will appear in Settings > Integrations
The Local Connector runs on your machine and communicates securely with Splox workflows. All operations execute locally on your computer.

​
Security

Local Execution

All commands run locally - nothing leaves your machine except results

Permission Control

Approve or deny each workflow action

Encrypted Connection

Secure communication with Splox platform

Access Logs

View all operations in connector logs
Important: Only use Local Machine integration with trusted workflows. Commands execute with your user permissions.

​
Available Actions

​
File Operations

Read contents of a file from your computer.Parameters:
  • path - File path to read
  • start_line - Starting line number (optional, default: 1)
  • num_lines - Number of lines to read (optional, default: 0 = all)
  • max_kb - Maximum KB to read (default: 8, max: 32)
Returns:
  • content - File contents
  • content_size - Content size in bytes
  • lines_read - Number of lines read
  • total_lines - Total lines in file
Write content to a file on your computer.Parameters:
  • path - File path to write
  • content - Content to write
Returns:
  • success - Write success status
  • path - Written file path
  • size - Written bytes
List files and directories.Parameters:
  • path - Directory path to list
Returns:
  • files - Array of file objects
    • name - File/directory name
    • path - Full path
    • size - File size (if file)
    • is_dir - Is directory flag
    • modified - Last modified time
Delete a file or directory.Parameters:
  • path - File/directory path to remove
  • recursive - Remove directories recursively (default: false)
Returns:
  • success - Deletion success status
  • path - Removed path
Create a directory.Parameters:
  • path - Directory path to create
Returns:
  • success - Creation success status
  • path - Created directory path
Check if a file or directory exists.Parameters:
  • path - Path to check
Returns:
  • exists - File exists status
  • is_dir - Is directory (if exists)
  • is_file - Is file (if exists)
  • size - File size (if file)
  • modified - Last modified time

​
Command Execution

Run a shell command on your computer.Parameters:
  • command - Shell command to execute
  • path - Working directory (optional)
  • timeout - Command timeout in seconds (default: 30)
Returns:
  • stdout - Command standard output
  • stderr - Command standard error
  • exit_code - Command exit code
Examples:
# macOS/Linux
ls -la
cat file.txt
python script.py

# Windows
dir
type file.txt
python script.py

​
Desktop Control

Advanced computer control capabilities.Parameters:
  • action - Action to perform
  • parameters - Action-specific parameters
Supported Actions:
  • Mouse movement and clicks
  • Keyboard input
  • Window management
  • Application control
Capture a screenshot of your screen.Parameters:
  • display - Display number (optional, default: primary)
  • region - Screenshot region (optional, default: full screen)
    • x, y, width, height
Returns:
  • image_url - Screenshot URL
  • width - Image width
  • height - Image height
  • format - Image format (PNG)

​
Notifications

Send a system notification to your desktop.Parameters:
  • title - Notification title
  • message - Notification message
  • icon - Notification icon (optional)
  • sound - Play sound (optional, default: true)
Returns:
  • success - Notification sent status
  • notification_id - Notification ID
Send a message through system messaging.Parameters:
  • text - Message text
  • files - Attached files (optional)
Returns:
  • success - Message sent status
  • message_id - Message ID
Play an audio file on your computer.Parameters:
  • audio_url - URL or path to audio file
  • volume - Volume level 0-100 (optional, default: 50)
Returns:
  • success - Playback status
  • duration - Audio duration in seconds

​
AI Code Editing

Quick AI-powered file editing on your computer.Parameters:
  • target_file - File path to edit
  • instructions - Edit instructions
  • code_edit - Code changes
Returns:
  • success - Edit success status
  • message - Edit confirmation
Pricing: $1.04/M input, $1.56/M outputLearn more about Morph →
AI-powered editing of large files on your computer.Parameters:
  • target_file - File path to edit
  • instructions - Detailed edit instructions
  • code_edit - Code changes with context markers
Returns:
  • success - Edit success status
  • message - Edit confirmation
  • usage - Token usage statistics
Pricing: $1.17/M input, $2.47/M outputLearn more about Morph →

​
Cloud Integration

Upload files from your computer directly to S3.Parameters:
  • files - Array of file objects
    • local_path - Path on your computer
    • filename - Custom filename (optional)
    • content_type - MIME type (optional)
Returns:
  • uploads - Array of uploaded file objects
    • url - S3 URL
    • filename - Uploaded filename
    • size - File size
    • local_path - Original local path

​
Use Cases

Automate Daily Tasks:
  • Organize downloads folder
  • Backup important files
  • Process screenshots
  • Generate reports
Example: Automatically sort files by type and date

​
Example Workflows

​
File Organization

Automatically organize downloads by file type:
  1. List Files in Downloads folder
  2. For each file:
    • Check file extension
    • Make Directory for file type if needed
    • Move file to appropriate folder
  3. Send Notification when complete

​
Automated Screenshot Analysis

Take screenshot and analyze with AI:
  1. Take Screenshot of active window
  2. Upload to S3 for storage
  3. Send to Claude for analysis
  4. Send Notification with results

​
Code Editing Automation

AI-powered code refactoring:
  1. Read File to get code
  2. Morph Edit Large to refactor
  3. Write File with changes
  4. Execute Command to run tests
  5. Send Notification if tests pass

​
Best Practices

Path Safety

  • Use absolute paths
  • Validate paths before operations
  • Avoid system directories
  • Handle path errors gracefully

Command Safety

  • Review commands before execution
  • Set appropriate timeouts
  • Handle errors properly
  • Log command outputs

Permissions

  • Run connector with minimal permissions
  • Approve sensitive operations manually
  • Monitor operation logs
  • Review workflow access

Error Handling

  • Always check success status
  • Handle file not found errors
  • Set reasonable timeouts
  • Log failures for debugging

​
FAQ

A lightweight connector app runs on your computer and communicates with Splox workflows. When a workflow needs to execute a local operation, it sends a secure request to your connector, which executes it locally and returns results.
Yes, with proper precautions:
  • Operations execute with your user permissions (not root/admin)
  • You can review and approve sensitive operations
  • All communication is encrypted
  • No operations execute without your connector running
  • View operation logs in the connector
Workflows requiring local operations will wait or timeout. You can configure timeout behavior in your workflow. The connector automatically reconnects when your computer comes back online.
No. Each connector is linked to one Splox account. Each user needs their own connector installation.
  • Local Machine: Controls your personal computer (macOS/Windows/Linux desktop)
  • Remote Server: SSH access to remote servers (cloud VMs, dedicated servers)
Local Machine is for desktop automation, Remote Server is for server management.
The connector is lightweight and uses minimal resources when idle. It only consumes CPU/memory when actively executing operations.

​
Resources

Download Connector

Get the Local Connector for your OS

Splox Dashboard

Manage integrations and workflows

Morph Editing

Learn about AI code editing

Get Help

Contact support for assistance