@fmode/studio

AI PaaS IDE for Vibe Coding - A cross-platform CLI tool that provides a powerful development environment powered by AI.

Quick Start

The fastest way to get started is using npx (no installation required):

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

Global Installation (Recommended for frequent use)

npm install -g @fmode/studio

Once installed, you can run:

fmode

Using npx (Run without installing)

npx @fmode/studio

Usage

Basic Usage

Start the server with default settings (port 16666, host 0.0.0.0):

fmode
# or
npx @fmode/studio

Custom Port

Start on a specific port:

fmode --port 16666
# or
npx @fmode/studio --port 16666

Custom Host

Start on a specific host:

fmode --host localhost --port 16666
# or
npx @fmode/studio --host localhost --port 16666

Environment Variables

You can also configure the server using environment variables:

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 <PORT> | -p | Set the server port (default: 16666) | | --host <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

Development Workflow

# Start the development server
fmode

# Start on port 16666 for local development
fmode --port 16666

# Start on localhost only
fmode --host localhost --port 16666

With npx (No Installation)

# 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

Port Already in Use

If you see an error that the port is already in use:

fmode --port 16666

Permission Issues

On Linux/macOS, if you get permission errors, make sure the executable has execute permissions:

chmod +x node_modules/@fmode/studio/dist/bin/fmode-*

Fallback to Node.js

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:

fmode --version
# or
npx @fmode/studio --version

Help

Display help information:

fmode --help
# or
npx @fmode/studio --help

License

© 2026 未来飞马® All rights reserved.

Author

Fmode Studio

• Fmode Inc
• RyaneMax

Links

• Repository: https://www.npmjs.com/package/@fmode/studio
• Issues: https://app.fmode.cn/dev/studio