AI PaaS IDE for Vibe Coding - Cross-platform CLI tool
npm install @fmode/studiobash
npx -y @fmode/studio
`
This will:
1. Download and run the latest version automatically
2. Start the development server on port 16666
3. Open your browser to the IDE
Installation
$3
`bash
npm install -g @fmode/studio
`
Once installed, you can run:
`bash
fmode
`
$3
`bash
npx @fmode/studio
`
Usage
$3
Start the server with default settings (port 16666, host 0.0.0.0):
`bash
fmode
or
npx @fmode/studio
`
$3
Start on a specific port:
`bash
fmode --port 16666
or
npx @fmode/studio --port 16666
`
$3
Start on a specific host:
`bash
fmode --host localhost --port 16666
or
npx @fmode/studio --host localhost --port 16666
`
$3
You can also configure the server using environment variables:
`bash
PORT=16666 HOST=localhost fmode
`
Available environment variables:
- PORT - Server port (default: 16666)
- HOST - Server host (default: 0.0.0.0)
- VITE_IS_PLATFORM - Set to 'true' for platform mode
Command Line Options
| Option | Alias | Description |
|--------|-------|-------------|
| --port | -p | Set the server port (default: 16666) |
| --host | -h | Set the server host (default: 0.0.0.0) |
| --help | | Show help message |
| --version | -v | Show version information |
| -y | | Auto-confirm (used with npx) |
Examples
$3
`bash
Start the development server
fmode
Start on port 16666 for local development
fmode --port 16666
Start on localhost only
fmode --host localhost --port 16666
`
$3
`bash
Quick start with auto-confirm
npx -y @fmode/studio
Specify custom port
npx @fmode/studio --port 16666
Full options
npx @fmode/studio --host localhost --port 16666
`
Platform Support
@fmode/studio provides native executables for the following platforms:
| Platform | Architecture | Executable |
|----------|--------------|------------|
| Windows | x64 | fmode-win-x64.exe |
| Windows | ARM64 | fmode-win-arm64.exe |
| Linux | x64 | fmode-linux-x64 |
| Linux | ARM64 | fmode-linux-arm64 |
| macOS | x64 (Intel) | fmode-macos-x64 |
| macOS | ARM64 (Apple Silicon) | fmode-macos-arm64 |
The CLI automatically detects your platform and uses the appropriate executable.
Requirements
- Node.js: >= 18.0.0
- Bun: >= 1.0.0 (optional, for development)
- OS: Windows, macOS, or Linux
- CPU: x64 or ARM64
Data Storage
Application data is stored in your user data directory:
- Windows: %APPDATA%\fmode-studio
- macOS: ~/Library/Application Support/fmode-studio
- Linux: ~/.config/fmode-studio
Troubleshooting
$3
If you see an error that the port is already in use:
`bash
fmode --port 16666
`
$3
On Linux/macOS, if you get permission errors, make sure the executable has execute permissions:
`bash
chmod +x node_modules/@fmode/studio/dist/bin/fmode-*
`
$3
If the native executable is not available for your platform, the CLI will automatically fall back to running with Bun (if installed).
Version Check
Check your installed version:
`bash
fmode --version
or
npx @fmode/studio --version
`
Help
Display help information:
`bash
fmode --help
or
npx @fmode/studio --help
``