Factory Bridge
Factory Bridge CLI Tools Reference
Comprehensive guide to the CLI tools available through Factory Bridge and how to use them effectively
Factory Bridge provides several powerful CLI tools that allow you to interact with your local environment directly from Factory. This reference guide covers each tool in detail, including usage examples and parameters.
Available CLI Tools
When you connect Factory to your local machine via Factory Bridge, you’ll have access to the following shell tools in Droid Mode:Execute Process
Run commands and scripts on your local machine
Kill Process
Terminate running processes
Pipe Process Input
Send input to running processes
Overview
Factory Bridge connects securely to your local machine, giving you access to powerful command-line capabilities directly within Factory. These tools allow you to execute commands, manage processes, and interact with running applications—all while maintaining your familiar workflow.Available CLI Tools
When connected via Factory Bridge, you’ll have access to these essential command-line tools:Execute Commands
Run commands and scripts directly from Factory
Manage Processes
Control running processes with ease
Interactive Input
Send input to running applications
Running Commands
Execute any command you would normally run in your terminal directly from Factory.How It Works
- Connect Factory Bridge to your local machine
- Ask Factory to run a command
- View the results directly in your conversation
Examples
List Files
List Files
Request:Factory will execute this command and show you the output:
Building Projects
Building Projects
Request:Factory will execute the build command and display the progress in real-time.
Starting Development Servers
Starting Development Servers
Request:Factory will start the server and stream the output, allowing you to monitor the process.
Managing Processes
Easily control processes that you’ve started through Factory.How It Works
- Start a process using Factory
- If needed, ask Factory to terminate the process
- Factory will safely shut down the process for you
Interactive Applications
Interact with command-line applications that require user input.How It Works
- Start an interactive process through Factory
- Send input as needed, including confirmation responses, text entries, and commands
- Factory will relay your input to the application and display the results
Examples
Database Operations
Database Operations
1
Connect to Database
Ask Factory to start your database client
2
Enter Credentials
Securely provide login information
3
Execute Queries
Run SQL commands as needed
4
Complete Session
Exit cleanly when finished
Git Workflow
Git Workflow
1
Check Status
View current repository status
2
Create Branches
Create and switch branches as needed
3
Stage Changes
Add modified files to staging
4
Commit Work
Commit with descriptive messages
5
Push Updates
Push changes to remote repositories
Best Practices
- Specify complete file paths when possible
- Use quotes for commands containing spaces or special characters
- Consider security implications before running sensitive commands
- Always verify process information before termination
Troubleshooting
Command Not Found
Command Not Found
- Verify the command is installed on your system
- Check if the command is in your system PATH
- Try using the full path to the executable
- Ensure you’re using the correct environment for specialized commands
Permission Issues
Permission Issues
- Check file and directory permissions
- Ensure you have appropriate access rights
- For scripts, verify they have execution permissions
- Use elevated privileges only when necessary and with caution
Process Communication
Process Communication
- Verify processes are still running before attempting interaction
- Check output logs for error messages
- Restart processes if connection is lost
Security Considerations
When using CLI tools through Factory Bridge, keep these security considerations in mind:- All commands execute with your user permissions on your local machine
- Avoid running commands that could expose sensitive information
- Be cautious with commands that make system changes
- Consider using dedicated environments for sensitive operations
Learn More About Factory Bridge
Return to the main Factory Bridge documentation for installation and general usage information