Skip to content

Add support for submodules #90

Description

@triplef

For various reasons we haven’t jumped on the monorepo train with our project and are using submodules for sub-components of our product. Reading the documentation it seems like submodules are not yet supported.

In order to associate issues fixed in submodules with Linear releases I think we’d need an option to have linear-release recurse into submodules to detect Linear issue references.

With this setup, linear-release would still only be called from the main (root) repo, and a release would still only be associated with a commit SHA from the main repo (as the submodule pointers are taken from that state of the main repo).

Your support suggested to manually scan the submodules in addition to the main repo, but I don’t think this would work for continuous pipelines, where every deployment creates a completed release. Also for scheduled pipelines it is unclear to me if a release can be associated with multiple repositories.

Activity

  1. linear-code commented on May 20, 2026

    @linear-code
    Contributor
  2. RomainCscn commented on May 22, 2026

    @RomainCscn
    Collaborator

    Thanks for the detailed context. Your understanding is right: submodules are not supported by linear-release today.

    The current limitation is that linear-release only scans the Git history of the repository it runs in. So when it runs from the root repo, it can see that a submodule pointer changed, but it won’t recurse into the submodule and scan the commits between the previous and current submodule SHAs.

    To make sure we’re thinking about the right solution, could you share a bit more about your workflow? In particular, are deployments triggered from the root repo only, and does each deployment correspond to one root commit plus the submodule SHAs pinned by that commit? Also, when a submodule pointer changes, do you already have a PR or commit in the root repo that represents that bump?

  3. triplef commented on May 22, 2026

    @triplef
    Author

    Thanks for looking into this, much appreciated! We’d love to use linear release, and this is I think the last thing blocking us.

    are deployments triggered from the root repo only, and does each deployment correspond to one root commit plus the submodule SHAs pinned by that commit?

    Yes, exactly!

    when a submodule pointer changes, do you already have a PR or commit in the root repo that represents that bump?

    I’m not sure I understand the question. Each submodule pointer change is triggered by a commit in the root repo (I don’t think there’s another way to change a submodule pointer?).

  4. removed their assignment
    on Jun 4, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions