phion

Phion Development Agent for file synchronization between your local project and Phion platform.

Installation

pnpm add phion

Usage

Using config file (recommended)

Create phion.config.json in your project root:

{
  "projectId": "your-project-id",
  "wsUrl": "ws://localhost:8080",
  "debug": false
}

Then run the agent:

phion

Using command line arguments

phion your-project-id

Using environment variables

export PHION_PROJECT_ID=your-project-id
export PHION_WS_URL=ws://localhost:8080
phion

Configuration

phion.config.json

• projectId (required) - Your Phion project ID
• wsUrl (optional) - WebSocket server URL (default: ws://localhost:8080)
• debug (optional) - Debug mode (default: false)

Environment variables

• PHION_PROJECT_ID - Project ID
• PHION_WS_URL - WebSocket server URL

Auto Updates

To get the latest agent updates, regularly update the package:

pnpm update phion

Features

• 🔄 Real-time sync of files with Phion platform
• 🔗 Git integration for rolling back changes and syncing with GitHub
• 📁 Smart file watching with automatic exclusion of build folders
• 🚀 Auto-reconnection when connection is lost
• ⚙️ Flexible configuration via file, environment variables, or arguments

System Requirements

• Node.js 18+
• Git (for git commands)

Support

If you experience issues with the agent:

1. Check your internet connection
2. Make sure WebSocket server is running
3. Verify your Project ID is correct
4. Restart agent: Ctrl+C and run phion again

Made with ❤️ by 21st Labs | Phion.dev