# How to get access to LocalHistoryImpl with Gradle Plugin 2.x?

**URL:** <https://platform.jetbrains.com/t/how-to-get-access-to-localhistoryimpl-with-gradle-plugin-2-x/1241>\
**Category:** IntelliJ Platform\
**Created:** [April 5, 2025, 11:46am UTC](https://platform.jetbrains.com/t/how-to-get-access-to-localhistoryimpl-with-gradle-plugin-2-x/1241 "2025-04-05T11:46:39Z")\
**Posts on this page:** 7\
**Page:** 1

<div class="post-metadata">

**Author:** ![Skrumpey](https://sea1.discourse-cdn.com/flex001/user_avatar/platform.jetbrains.com/skrumpey/32/1024_2.png) [@Skrumpey](https://platform.jetbrains.com/u/Skrumpey)\
**Post date:** [April 5, 2025, 11:46am UTC](https://platform.jetbrains.com/t/how-to-get-access-to-localhistoryimpl-with-gradle-plugin-2-x/1241/1 "2025-04-05T11:46:39Z")

</div>

I’m working on a plugin trying to extract the Local History of a project/file, but I cannot get access to the LocalHistoryImpl class when using the IntelliJ Plugin Template from Github.

The LocalHistory class itself doesnt offer the needed methods to retrieve the Local History, I would need the Impl-class for that. Is there anything i need to change/add in my plugin.xml or gradle build files?

```xml
<!-- Plugin Configuration File. Read more: https://plugins.jetbrains.com/docs/intellij/plugin-configuration-file.html -->
<idea-plugin>
    <id>com.github.skrumpey.localhistoryextractor</id>
    <name>LocalHistoryExtractor</name>
    <vendor>skrumpey</vendor>

    <depends>com.intellij.modules.platform</depends>

    <extensions defaultExtensionNs="com.intellij">

    </extensions>

    <resource-bundle>messages.MyBundle</resource-bundle>

    <extensions defaultExtensionNs="com.intellij">
        <toolWindow factoryClass="com.github.skrumpey.localhistoryextractor.toolWindow.MyToolWindowFactory" id="MyToolWindow"/>
        <postStartupActivity implementation="com.github.skrumpey.localhistoryextractor.startup.MyProjectActivity" />
    </extensions>

    <actions>
        <action class="com.github.skrumpey.localhistoryextractor.ExtractorClass" id="com.github.skrumpey.localhistoryextractor.ExtractorClass" text="Extract Local History">
            <add-to-group group-id="EditorPopupMenu" anchor="last"/>
        </action>
    </actions>
</idea-plugin>

```

```Kotlin
import org.jetbrains.changelog.Changelog
import org.jetbrains.changelog.markdownToHTML
import org.jetbrains.intellij.platform.gradle.TestFrameworkType

plugins {
    id("java") // Java support
    alias(libs.plugins.kotlin) // Kotlin support
    alias(libs.plugins.intelliJPlatform) // IntelliJ Platform Gradle Plugin
    alias(libs.plugins.changelog) // Gradle Changelog Plugin
    alias(libs.plugins.qodana) // Gradle Qodana Plugin
    alias(libs.plugins.kover) // Gradle Kover Plugin
}

group = providers.gradleProperty("pluginGroup").get()
version = providers.gradleProperty("pluginVersion").get()

// Set the JVM language level used to build the project.
kotlin {
    jvmToolchain(21)
}

// Configure project's dependencies
repositories {
    mavenCentral()

    // IntelliJ Platform Gradle Plugin Repositories Extension - read more: https://plugins.jetbrains.com/docs/intellij/tools-intellij-platform-gradle-plugin-repositories-extension.html
    intellijPlatform {
        defaultRepositories()

    }
}

// Dependencies are managed with Gradle version catalog - read more: https://docs.gradle.org/current/userguide/platforms.html#sub:version-catalog
dependencies {
    testImplementation(libs.junit)
    testImplementation(libs.opentest4j)

    // IntelliJ Platform Gradle Plugin Dependencies Extension - read more: https://plugins.jetbrains.com/docs/intellij/tools-intellij-platform-gradle-plugin-dependencies-extension.html
    intellijPlatform {
        create(providers.gradleProperty("platformType"), providers.gradleProperty("platformVersion"))

        // Plugin Dependencies. Uses `platformBundledPlugins` property from the gradle.properties file for bundled IntelliJ Platform plugins.
        bundledPlugins(providers.gradleProperty("platformBundledPlugins").map { it.split(',') })

        // Plugin Dependencies. Uses `platformPlugins` property from the gradle.properties file for plugin from JetBrains Marketplace.
        plugins(providers.gradleProperty("platformPlugins").map { it.split(',') })

        testFramework(TestFrameworkType.Platform)
    }
}

// Configure IntelliJ Platform Gradle Plugin - read more: https://plugins.jetbrains.com/docs/intellij/tools-intellij-platform-gradle-plugin-extension.html
intellijPlatform {
    pluginConfiguration {
        name = providers.gradleProperty("pluginName")
        version = providers.gradleProperty("pluginVersion")

        // Extract the <!-- Plugin description --> section from README.md and provide for the plugin's manifest
        description = providers.fileContents(layout.projectDirectory.file("README.md")).asText.map {
            val start = "<!-- Plugin description -->"
            val end = "<!-- Plugin description end -->"

            with(it.lines()) {
                if (!containsAll(listOf(start, end))) {
                    throw GradleException("Plugin description section not found in README.md:\n$start ... $end")
                }
                subList(indexOf(start) + 1, indexOf(end)).joinToString("\n").let(::markdownToHTML)
            }
        }

        val changelog = project.changelog // local variable for configuration cache compatibility
        // Get the latest available change notes from the changelog file
        changeNotes = providers.gradleProperty("pluginVersion").map { pluginVersion ->
            with(changelog) {
                renderItem(
                    (getOrNull(pluginVersion) ?: getUnreleased())
                        .withHeader(false)
                        .withEmptySections(false),
                    Changelog.OutputType.HTML,
                )
            }
        }

        ideaVersion {
            sinceBuild = providers.gradleProperty("pluginSinceBuild")
            untilBuild = providers.gradleProperty("pluginUntilBuild")
        }
    }

    signing {
        certificateChain = providers.environmentVariable("CERTIFICATE_CHAIN")
        privateKey = providers.environmentVariable("PRIVATE_KEY")
        password = providers.environmentVariable("PRIVATE_KEY_PASSWORD")
    }

    publishing {
        token = providers.environmentVariable("PUBLISH_TOKEN")
        // The pluginVersion is based on the SemVer (https://semver.org) and supports pre-release labels, like 2.1.7-alpha.3
        // Specify pre-release label to publish the plugin in a custom Release Channel automatically. Read more:
        // https://plugins.jetbrains.com/docs/intellij/deployment.html#specifying-a-release-channel
        channels = providers.gradleProperty("pluginVersion").map { listOf(it.substringAfter('-', "").substringBefore('.').ifEmpty { "default" }) }
    }

    pluginVerification {
        ides {
            recommended()
        }
    }
}

// Configure Gradle Changelog Plugin - read more: https://github.com/JetBrains/gradle-changelog-plugin
changelog {
    groups.empty()
    repositoryUrl = providers.gradleProperty("pluginRepositoryUrl")
}

// Configure Gradle Kover Plugin - read more: https://github.com/Kotlin/kotlinx-kover#configuration
kover {
    reports {
        total {
            xml {
                onCheck = true
            }
        }
    }
}

tasks {
    wrapper {
        gradleVersion = providers.gradleProperty("gradleVersion").get()
    }

    publishPlugin {
        dependsOn(patchChangelog)
    }
}

intellijPlatformTesting {
    runIde {
        register("runIdeForUiTests") {
            task {
                jvmArgumentProviders += CommandLineArgumentProvider {
                    listOf(
                        "-Drobot-server.port=8082",
                        "-Dide.mac.message.dialogs.as.sheets=false",
                        "-Djb.privacy.policy.text=<!--999.999-->",
                        "-Djb.consents.confirmation.enabled=false",
                    )
                }
            }

            plugins {
                robotServerPlugin()
            }
        }
    }
}

```

---

<div class="post-metadata">

**Author:** ![yuriy.artamonov](https://sea1.discourse-cdn.com/flex001/user_avatar/platform.jetbrains.com/yuriy.artamonov/32/48_2.png) [@yuriy.artamonov](https://platform.jetbrains.com/u/yuriy.artamonov)\
**Post date:** [April 5, 2025, 2:04pm UTC](https://platform.jetbrains.com/t/how-to-get-access-to-localhistoryimpl-with-gradle-plugin-2-x/1241/2 "2025-04-05T14:04:27Z")

</div>

> [@Skrumpey](#):
>
> LocalHistoryImpl

It is implementation detail and Internal API, please do not try to use it. Use `LocalHistoryEx` and/or `LocalHistory` only

Plugins with `LocalHistoryImpl` usage may not be published on Marketplace at the moment

---

<div class="post-metadata">

**Author:** ![Skrumpey](https://sea1.discourse-cdn.com/flex001/user_avatar/platform.jetbrains.com/skrumpey/32/1024_2.png) [@Skrumpey](https://platform.jetbrains.com/u/Skrumpey)\
**Post date:** [April 5, 2025, 3:31pm UTC](https://platform.jetbrains.com/t/how-to-get-access-to-localhistoryimpl-with-gradle-plugin-2-x/1241/3 "2025-04-05T15:31:44Z")

</div>

Hi, thanks for the info, sadly I also can’t import LocalHistoryEx. I only have LocalHistory, LocalHistoryAction and LocalHistoryException using the above mentioned plugin setup.

---

<div class="post-metadata">

**Author:** ![Skrumpey](https://sea1.discourse-cdn.com/flex001/user_avatar/platform.jetbrains.com/skrumpey/32/1024_2.png) [@Skrumpey](https://platform.jetbrains.com/u/Skrumpey)\
**Post date:** [April 6, 2025, 2:52pm UTC](https://platform.jetbrains.com/t/how-to-get-access-to-localhistoryimpl-with-gradle-plugin-2-x/1241/4 "2025-04-06T14:52:42Z")

</div>

@yuriy.artamonov Sorry for bothering you again but it’s kind of urgent, I can’t figure out how to import LocalHistoryEx 😅

---

<div class="post-metadata">

**Author:** ![yuriy.artamonov](https://sea1.discourse-cdn.com/flex001/user_avatar/platform.jetbrains.com/yuriy.artamonov/32/48_2.png) [@yuriy.artamonov](https://platform.jetbrains.com/u/yuriy.artamonov)\
**Post date:** [April 6, 2025, 7:08pm UTC](https://platform.jetbrains.com/t/how-to-get-access-to-localhistoryimpl-with-gradle-plugin-2-x/1241/5 "2025-04-06T19:08:18Z")

</div>

> [@yuriy.artamonov](#):
>
> `LocalHistoryEx`

It is located in the platform module `intellij.platform.lvcs.impl` that can be added to classpath via:

```kotlin
dependencies {
    intellijPlatform {
        create("IC", "2024.3.4")

        bundledModule("intellij.platform.lvcs.impl")
    }
}

```

`LocalHistoryEx` requires API 2024.3 at least.

Dependencies in plugin.xml must be declared this way:

```auto
<dependencies>
    <module name="intellij.platform.lvcs.impl"/>
</dependencies>

```

Also, let us remind you that this is community forum, we do our best to help you. For urgent questions we may suggest some enterprise support options in the future.

---

<div class="post-metadata">

**Author:** ![Skrumpey](https://sea1.discourse-cdn.com/flex001/user_avatar/platform.jetbrains.com/skrumpey/32/1024_2.png) [@Skrumpey](https://platform.jetbrains.com/u/Skrumpey)\
**Post date:** [April 6, 2025, 8:25pm UTC](https://platform.jetbrains.com/t/how-to-get-access-to-localhistoryimpl-with-gradle-plugin-2-x/1241/6 "2025-04-06T20:25:47Z")

</div>

Hi, thanks and sorry again for bothering on a sunday.

This worked, thank you!

I don’t think I actually care about publishing the plugin, it’s more of a private thing anyways, so I should be able to just use LocalHistoryImpl anyways. Sadly it doesn’t seem like I can get my main goal (extracting the local history of a project/file) to work anyways as there are no proper methods (as far as I can tell) that let me do that 😅

---

<div class="post-metadata">

**Author:** ![yuriy.artamonov](https://sea1.discourse-cdn.com/flex001/user_avatar/platform.jetbrains.com/yuriy.artamonov/32/48_2.png) [@yuriy.artamonov](https://platform.jetbrains.com/u/yuriy.artamonov)\
**Post date:** [April 6, 2025, 8:39pm UTC](https://platform.jetbrains.com/t/how-to-get-access-to-localhistoryimpl-with-gradle-plugin-2-x/1241/7 "2025-04-06T20:39:48Z")

</div>

Internal API also means we will inevitably break it without any written notice.

And even make it so your code no longer compiles, so all risks are on you.

Literally it means we do not consider it API