JetBrains Fleet 1.42 Help

Workspace

JetBrains Fleet uses the concept of Workspace to define the scope of the code you are working on. In practical terms, a workspace is a folder, either on a local or remote system, that contains the files you need for development.

Open a local workspace

  1. Press ⌘ O or select File | Open from the main menu.

  2. Select the folder and click Open.

Another way to create a workspace is to clone a repository from VCS. The repository opens in a separate window.

Clone a repository

  1. From the Workspaces menu, select Clone from Git.

    Clone from Git menu item
  2. In Source URL and Location fields, specify the repository URL and the desired git-clone location.

    Welcome screen with clone credentials
  3. Click Clone.

When you open a workspace, you can view the hierarchy of files that belong to it in the Files tree.

The Files view in the left panel

If you need to work with multiple locations, you can attach additional folders to the open workspace.

Attach multiple folders

  1. Press ⌘ ⇧ K and start typing Add Folder. Select Add Folder.

    Searching for the Add Folder action using the Go to popup
  2. Select a folder. The selected folder gets attached alongside the existing one.

    The attached directory appears in the Files tool

Rename a workspace

  • Click the workspace name and select Rename Workspace. Type a new name and press .

    Rename a workspace
  • Press ⌘ ⇧ K and start typing Rename Workspace. Select Rename Workspace. Type a new name and press .

Creating a workspace with AI in JetBrains Fleet

JetBrains Fleet provides a feature that allows users to generate a workspace using AI. This functionality streamlines the initial setup process by creating the necessary structure and providing example code tailored to the desired template.

Create a workspace with AI

  1. Launch JetBrains Fleet.

  2. On the welcome screen, click the Create with AI button.

    When you click this button, JetBrains Fleet opens the AI Assistant view.

  3. In the AI Assistant view, type the prompt and specify what kind of a template you want to generate.

    The AI will use this information to build the project structure and insert example code into the generated files.

  4. Click the Create Workspace button and select an empty directory on your hard drive where the workspace will be saved. Ensure that the directory is empty.

    With the workspace set up, you can begin developing your project. Use the example code as a starting point and customize it as needed.

Workspace settings

In addition to user settings, which apply globally to all files, you can specify settings for a particular workspace. These settings will only apply to files in this folder, and will be shared among all the users of the workspace.

Edit workspace settings through the menu

  1. Open the workspace, whose settings you want to edit.

  2. Open settings by pressing ⌘ ,. Alternatively, use the main menu:

    • Windows and Linux: click the Menu icon and navigate to File | Settings | Settings.

      workspace settings
    • macOS: from the main menu, click Fleet | Settings.

      workspace settings
  3. Open the tab that corresponds to your workspace.

    The 'SPRING-PETCLINIC' tab in Settings/Preferences

Edit workspace settings through settings.json

  1. In the workspace settings menu, select Show settings.json.

    Alternatively, open the .fleet folder in the workspace, whose settings you want to edit. If no settings have been defined for the workspace, and the .fleet folder does not exist, create the folder and the settings.json file in it.

  2. Fill in settings.json with the required settings using JSON syntax.

    For available settings and their descriptions, refer to Settings reference.

    Editing settings in settings.json

    Changes are applied immediately when you save the file.

Subfolder settings

Workspaces support nested settings in their subfolders. You can use them to achieve any level of granular control when you need custom settings for subfolders.

settings.json in a workspace subdirectory

To achieve the necessary granularity, create .fleet/settings.json in a subfolder. When you are working with files inside the subfolder, these settings will override the more general workspace settings.

Application settings

You can change the default directory locations for JetBrains Fleet. Specifically, you can set new paths for your configuration, caches, and plugins.

Default locations

Configuration directory

Windows

%APPDATA%\JetBrains\Fleet

Linux

~/.config/JetBrains/Fleet

macOS

~/Library/Application Support/Jetbrains/Fleet

Caches Directory

Windows

%LOCALAPPDATA%\JetBrains\Fleet

Linux

~/.cache/JetBrains/Fleet

macOS

~/Library/Caches/JetBrains/Fleet

Plugins Directory

WS Server

<config_path>/pluginStorage

Frontend

<config_path>/plugins

Change directory locations by using the fleet.properties file

  1. Locate the fleet.properties file. The default locations of the file are:

    • Home directory: ~/fleet.properties

    • Default caches directory: <caches_dir>/fleet.properties. Value of <caches_dir> depends on your operating system. For more information, refer to Caches Directory.

  2. Open fleet.properties in an editor and add the following properties to the file:

    • fleet.config.path=<your_custom_path>: sets a path to the configuration directory.

    • fleet.caches.path=<your_custom_path>: sets a path to the caches directory.

    • fleet.log.path=<your_custom_path>: sets a path to the logging directory.

Change directory locations from JetBrains Fleet

  1. Press ⌘ ⇧ , to open settings.json. A separate editor tab opens. In the opened tab, specify the required settings using JSON syntax.

  2. Add the following property to settings.json.

    "internalMode": true
  3. Press ⌘ ⇧ K and type Open FleetCfg.

    Enabling internal mode
  4. In the Fleet.cfg file, add the following properties:

    • java-options=-Dfleet.config.path=<custom_path>: a property that sets a path to the configuration directory.

    • java-options=-Dfleet.caches.path=<custom_path>: a property that sets a path to the caches directory.

    • java-options=-Dfleet.log.path=<custom_path>: a property that sets a path to the logging directory.

  5. Restart JetBrains Fleet.

Set a location of fleet.properties with the FLEET_PROPERTIES_FILE environment variable

  • To set the location of the fleet.properties file, follow the procedure for your operating system:

Press Win + R, type cmd, and press .

Type set FLEET_PROPERTIES_FILE=C:\path\to\your\file and press . This will set the variable for the current session only.

To set the environment variable permanently, consider adding it in the System Properties window.

System Properties

Search for the Terminal application in the Utilities folder within your Applications folder, or use Spotlight to search for it.

Type export FLEET_PROPERTIES_FILE=/path/to/your/file and press . This will set the variable for the current terminal session only.

To set the environment variable permanently, consider adding export FLEET_PROPERTIES_FILE=/path/to/your/file to .bashrc for bash or .zshrc for zsh.

System Properties

Search for Terminal in your application menu or by using a keyboard shortcut, often it is Ctrl+Alt+T.

Type export FLEET_PROPERTIES_FILE=/path/to/your/file and press . This will set the FLEET_PROPERTIES_FILE variable for the current session only.

To set the environment variable permanently, consider adding export FLEET_PROPERTIES_FILE=/path/to/your/file to .bashrc, .bash_profile, or .profile files.

Linux FLEET_PROPERTIES_FILE
Last modified: 20 September 2024