Rebased detachhead

Use this command to install Rebased:

winget install --id=detachhead.rebased -e

An open-source remake of the short-lived jetbrains git client

Rebased

A git client based on the IntelliJ platform.

This project aims to be an open-source remake of the short-lived jetbrains git client. It's basically just a JetBrains IDE with all the bundled plugins removed except the git integration, with some additional UI tweaks.

Why?

See this youtrack issue for the many reasons people have been requesting this for almost a decade. At the time of writing, it's the #3 most upvoted open issue on YouTrack.

Installation

Download from GitHub releases

> [!TIP] > For linux users, we recommend using either AppManager or Gear Lever to install the AppImage to your applications menu, and for automatic updates.

> [!NOTE] > For macOS users, after copying Rebased.app to your Applications folder, you may see the following error message: > > "Rebased.app" is damaged and can't be opened. You should move it to the Bin. > > This is Apple lying to you. Nothing is "damaged", it's just not code-signed with an Apple Developer certificate. To fix it, run the following command: > bash > xattr -rd com.apple.quarantine /Applications/Rebased.app >

Credits

https://github.com/obiscr/intellij-community - a previous attempt at creating a jetbrains git client that i cherrypicked some commits from
jetbrains, obviously

> [!NOTE] > The remainder of this readme is mostly unchanged from the upstream intellij-community repo.

Getting the Source Code

This section will guide you through getting the project sources and help avoid common issues in git config and other steps before opening it in the IDE.

Prerequisites

Git installed
Install IntelliJ IDEA 2023.2 or higher.

For Windows set these git config to avoid common issues during cloning:

git config --global core.longpaths true
git config --global core.autocrlf input

Clone Main Repository

IntelliJ open source repository is available from the GitHub repository, which can be cloned or downloaded as a zip file (based on a branch) into ``. The master (default) branch contains the source code which will be used to create the next major version of all JetBrains IDEs. The branch names and build numbers for older releases of JetBrains IDEs can be found on the Build Number Ranges page.

You can clone this project directly using IntelliJ IDEA.

Alternatively, follow the steps below in a terminal:

git clone https://github.com/detachhead/rebased.git --recurse-submodules
cd rebased

> [!TIP] > - For faster download: If the complete repository history isn't needed, create shallow clone > To download only the latest revision of the repository, add --depth 1 option after clone. > - Cloning in IntelliJ IDEA also supports creating shallow clone.

> [!NOTE] > This project requires additional Android modules from separate Git repositories, which is why --recurse-submodules is needed. Ideally these should not be needed since Rebased > is not built with the Android plugin, but it seems too tightly integrated with the codebase to be able to easily remove it. So for now I've kept it as a git submodule instead of > relying on a script. This way, the project is always pinned to a version of the android repo that works with it.

Building Rebased

> Standard GitHub runners can no longer be used to build the project due to the disk size limitation. > Now we use larger runners which are only available for organizations and enterprises using the GitHub Team or GitHub Enterprise Cloud plans. > Users of personal GitHub accounts can use the prebuilt binaries, > or build IntelliJ IDEA from source code locally.

These instructions will help you build Rebased from source code, which is based on the IntelliJ community edition. These instructions are mostly unchanged from upstream for now so they might be inaccurate because this project is still in early development and I am still learing how everything works and changing things around. IntelliJ IDEA '2023.2' or newer is required.

Opening the IntelliJ IDEA Source Code in the IDE

Using the latest IntelliJ IDEA, click 'File | Open', select the `` directory. If IntelliJ IDEA displays a message about a missing or out-of-date required plugin (e.g. Kotlin), enable, upgrade, or install that plugin and restart IntelliJ IDEA.

Build Configuration Steps

JDK Setup

Use JetBrains Runtime 21 (without JCEF) to compile
- IDE will prompt to download it on the first build > [!IMPORTANT] > > JetBrains Runtime without JCEF is required. If jbr-21 SDK points to JCEF version, change it to the non-JCEF version: > - Add idea.is.internal=true to idea.properties and restart the IDE. > - Go to 'Project Structure | SDKs' > - Click 'Browse' → 'Download...' > - Select version 21 and vendor 'JetBrains Runtime' > - To confirm if the JDK is correct, navigate to the SDK page with jbr-21 selected. Search for jcef, it should NOT yield a result.

Maven Configuration : If the Maven plugin is disabled, add the path variable "MAVEN_REPOSITORY" pointing to /.m2/repository directory.
Memory Settings

Ensure a minimum 8GB RAM on your computer.
With the minimum RAM, disable "Compile independent modules in parallel" in 'Settings | Build, Execution, Deployment | Compiler'.
With notably higher available RAM, Increase "User-local heap size" to 3000.

Building the IntelliJ IDEA Application from Source

To build IntelliJ IDEA from source, choose 'Build | Build Project' from the main menu.

To build installation packages, run the installers.cmd script in `` directory. installers.cmd will work on both Windows and Unix systems. Options to build installers are passed as system properties to installers.cmd command. You may find the list of available properties in BuildOptions.kt

Installer build examples:

# Build installers only for current operating system:
./installers.cmd -Dintellij.build.target.os=current

# Build source code _incrementally_ (do not build what was already built before):
./installers.cmd -Dintellij.build.incremental.compilation=true

> [!TIP] > > The installers.cmd is used to run OpenSourceCommunityInstallersBuildTarget from the command line. > You can also call it directly from IDEA, using run configuration Build IntelliJ IDEA Installers (current OS).

Dockerized Build Environment

To build installation packages inside a Docker container with preinstalled dependencies and tools, run the following command in `` directory (on Windows, use PowerShell):

docker build . --target intellij_idea --tag intellij_idea_env
docker run --rm --user "$(id -u)" --volume "${PWD}:/community" intellij_idea_env

> [!NOTE] > > Please remember to specify the --user "$(id -u)" argument for the container's user to match the host's user. > This prevents issues with permissions for the checked-out repository, the build output, and the mounted Maven cache, if any. > To reuse the existing Maven cache from the host system, add the following option to docker run command: --volume "$HOME/.m2:/home/ide_builder/.m2"

Running IntelliJ IDEA

To run the IntelliJ IDEA that was built from source, choose 'Run | Run' from the main menu. This will use the preconfigured run configuration IDEA.

To run tests on the build, apply these settings to the 'Run | Edit Configurations... | Templates | JUnit' configuration tab:

Working dir: /bin
VM options: -ea

Running IntelliJ IDEA in CI/CD environment

To run tests outside of IntelliJ IDEA, run the tests.cmd command in `` directory.tests.cmd can be used in both Windows and Unix systems. Options to run tests are passed as system properties to tests.cmd command. You may find the list of available properties in TestingOptions.kt

# Build source code _incrementally_ (do not build what was already built before): `
./tests.cmd -Dintellij.build.incremental.compilation=true

#Run a specific test: 
./tests.cmd -Dintellij.build.test.patterns=com.intellij.util.ArrayUtilTest

tests.cmd is used just to run CommunityRunTestsBuildTarget from the command line. You can also call it directly from IDEA, see run configuration tests for an example.