IDE
CLI

Profile ​

CodeBuddy offers hundreds of settings, thousands of extensions, and countless ways to adjust the UI layout, allowing you to fully customize this AI-powered editor. The CodeBuddy Profiles feature lets you create multiple custom configuration sets, switch between them instantly, and share them with others. This article explains how to use the Profile Editor to create, modify, export, and import profiles.

Opening the Profile Editor ​

The Profile Editor is a centralized tool for creating and managing CodeBuddy profiles. Open it using either of the following methods:

  1. Click the top menu File > Preferences > Profile. 

  2. The Profile Editor opens.

Creating a Profile ​

By default, CodeBuddy treats your current editor configuration as the Default Profile. Any changes you make—such as themes, keybindings, installed extensions, or UI layout adjustments—are recorded in this Default Profile.

Create ​

  1. In the Profile Editor, click New Profile.

  2. In the New Profile form, complete the following:

    • Name: Enter a profile name, e.g. “Data Science”.

    • Icon: Pick an icon for quick identification in the activity bar.

    • Copy from: Choose the base content source. Only two options are supported:

      • Existing Profiles: Clone content from another profile, e.g. Default.

      • None: Create an empty profile without any custom settings, extensions, or snippets.

  3. (Optional) In the Contents area, check the subsets you want to include—e.g. only “Settings” and “Extensions”, but not “Keybindings” and “Snippets”. Unchecked items will inherit from the Default Profile.

  4. Click Preview to open a new CodeBuddy window and verify the configuration. When satisfied, click Create to finish.

Viewing the Active Profile ​

You can identify the currently active profile in two ways:

  • Click File > Preferences > Profile; the active profile is marked on the left.

  • In the Profile Editor, the active profile is labeled “Active” on the right side of the list.

Configuring a Profile ​

Customizing a profile is identical to normal CodeBuddy configuration; all changes are auto-saved to the active profile. You can:

  • Extensions: install, uninstall, or disable them.

  • Editor settings: change themes, font size, formatting rules, etc.

  • UI layout: move panels (e.g. terminal to the right), hide views (e.g. Explorer sidebar).

Workspace Association ​

Profiles are automatically associated with the currently opened folder or workspace:

  • When you open a folder linked to a profile, CodeBuddy auto-loads that profile.

  • When you open a new folder already linked to another profile, CodeBuddy switches to that profile.

  • In the Profile Editor’s Folders & Workspaces section you can see every linked path (local or GitHub repo) and click Add Folder to associate additional folders.

Managing Profile ​

Switching Profile ​

Three quick ways to switch:

  • Command Palette: press Ctrl+Shift+P (Win/Linux) or Cmd+Shift+P (macOS), type “Profiles: Switch Profile”, then pick the target.

  • Top menu: File > Preferences > Profile, then select the desired profile.

  • In the Profile Editor, hover over a profile and click Use this Profile for Current Window.

Editing a Profile ​

Inside the Profile Editor you can change the profile’s Name, Icon, and Contents.

Deleting a Profile ​

可以通过下面两种方式删除配置文件：

Note：:the Default Profile cannot be deleted.

  • Hover the target profile, click More Actions on the right, then choose Delete.

  • Command Palette: open it (Ctrl+Shift+P / Cmd+Shift+P), type Delete Profile, and select the profile to remove.

Duplicating a Profile ​

Hover the source profile, click More Actions, then choose Duplicate to create an identical copy you can modify without affecting the original.

Opening a New Window with a Profile ​

  1. In the Profile Editor, select the target profile and click Use for New Windows. Any window opened via File → New Window will use this profile by default.

  2. Alternatively, click File > New Window with Profile and pick the desired profile.

Applying a Single Setting to All Profiles ​

To make a setting—e.g. auto-save—effective across every profile:

  1. Go to Accounts > Settings, hover the desired setting, click More Actions on the left, and choose Apply Setting to all Profiles. Future changes to this setting will sync to every profile.

  2. To stop syncing, uncheck Apply Setting to all Profiles in the same menu.

Applying a Single Extension to All Profiles ​

To keep an extension—e.g. Python—available in every profile:

  1. In the activity bar, open Extensions, locate the target extension, click its Manage button, and choose Apply Extension to all Profiles. The extension will be enabled in every profile.

  2. To stop syncing, uncheck Apply Extension to all Profiles in the same menu.

Sharing Profile ​

Profiles can be exported as local files or GitHub Gists for easy sharing, and you can import shared profiles to replicate development environments quickly.

Exporting a Profile ​

  1. In the Profile Editor, hover the profile, click More Actions, then choose Export.

  2. Pick an export method. Export to GitHub GistStep 1: If not logged in to GitHub, you’ll be prompted to sign in. Step 2: After login, a private Gist containing the profile is created. Only people with the link can access it. Click Copy Link to obtain the share URL. Step 3: When someone opens the link, local CodeBuddy is launched to preview the configuration. Alternatively, in the Profile Editor click the dropdown next to New Profile and choose Import Profile to import it locally. Step 4: You can manage the exported Gist via the link below, such as renaming, deleting, etc.

    bash
    [https://gist.github.com/username]（请将 username 替换为您的 GitHub 用户名）

Export as Local File

Choose Local file, pick a save path, and the profile is stored with the extension .code-profile.

Importing a Profile ​

  1. In the Profile Editor, click the dropdown next to New Profile and choose Import Profile.

  2. Select the source.

    • For a GitHub Gist, paste the share link.

    • For a local file, pick the .code-profile file.

  3. After import, the profile creation form opens, letting you adjust Name, Icon, and Contents. Click Create when ready.

Common Use Cases ​

Tailoring by Development Scenario ​

Avoid conflicts by creating scenario-specific profiles:

  • JavaScript Front-end: install Vite, ESLint, Prettier; set React/Vue snippets; enable “format on save”.

  • Python Back-end: install Pylance, Ruff, Jupyter; set Python interpreter; enable “remove unused imports”.

Demo Scenarios ​

Create a dedicated profile for presentations without affecting daily work:

  • Use a larger font (e.g. 16 px), high-contrast theme (e.g. Monokai), and hide unrelated views (e.g. Git panel) so the audience can clearly follow.

  • After the demo, simply close the window—your usual setup remains untouched.

Educational Scenarios ​

Teachers can prepare a uniform environment and share it with students:

  • For a “Computer Science” course, pre-install linters (ESLint, Ruff) and educational extensions (Code Spell Checker), and disable distracting features (auto-suggestions).

  • Students import the profile and start learning immediately without manual setup.

Troubleshooting ​

Use an empty profile to determine whether an issue stems from custom settings or extensions:

  • An empty profile disables all extensions and custom settings, leaving only core CodeBuddy functionality.

  • If the issue disappears, it’s caused by an extension or setting; if it persists, it may be a core CodeBuddy bug.