Submodules

The Submodules tab manages nested git repositories within your project. It can appear as a mode within Git Settings or as a standalone content tab.

Submodule List

Each submodule is displayed as a card showing:

• Name and status badges (Not initialized, Dirty, Modified)
• URL, branch, HEAD commit, and expected commit
• Action buttons — Initialize, Open, Update, Remove

Header Actions

Button	Action
Add Submodule	Open dialog to add a new submodule
Init All	Initialize all uninitialized submodules
Update All	Update all submodules to expected commits
Open .gitmodules	Open the .gitmodules file in the editor

Submodule Operations

Initialize

Run git submodule init to register an uninitialized submodule.

Open

Open the submodule as a regular Folder app tab with a parent link back to this repository.

Update

Check out the commit that the parent repository expects. Use the overflow menu for Update with nested submodules to recursively update.

Advanced Operations

The overflow menu (chevron button) on each submodule card provides:

• Fetch from remote — pull updates from the submodule’s remote
• Change URL — update the submodule’s remote URL
• Change tracked branch — switch which branch the submodule tracks
• Repair remote URL — sync from .gitmodules
• Remove submodule — completely remove the submodule entry

Conflict State

During merge or rebase conflicts, submodule operations are disabled. Resolve conflicts in the Changes tab first.