Repository navigation
Git worktree projects
Milimarty edited this page Oct 19, 2026
·
1 revision
A git worktree (or a submodule) has a .git file, not a folder: it points to its repository's git folder
somewhere else. Inside keel's container that path did not exist, so git said "not a git repository".
~/Projects/shop/.git/ ← the repository's git folder
~/Projects/shop-feature/.git (a file) → "gitdir: ~/Projects/shop/.git/worktrees/shop-feature"
│
keel2 start / add ─ mounts both, at the same path as on your computer ─ git works in the container
- From 0.18.17,
keel2 startandkeel2 addalso mount the repository's git folder, at the same path. keel2 says so: "… is a git worktree or submodule: its repository … is mounted too". - Get the new
keel2script for this (curl -fsSL https://raw.githubusercontent.com/MiladNalbandi/keel-v2/main/install.sh | bash), thenkeel2 restart. - When keel still cannot see the repository, the message says which folder keel checked, what git said (a folder keel cannot see, git's "dubious ownership"…) and the fix.
- Native mode needs nothing: keel runs on your computer and sees every path.
From docs/GUIDE.md · All pages
keel v2
- Home
- How a flow works
- Flows in detail
- Web research
- Rules
- KeelBot
- keel TUI (keel2 tui)
- Thinking effort
- Plugins and the Marketplace
- Stacks
- Plugins: Database, Git and CI/CD
- Quality
- Inbox and run modes
- Usage and caps
- Tasks and Jira
- Logins
- Signing in
- Use keel from Claude Code or Claude Desktop (MCP)
- keel2 commands
- Where keel keeps its files (layouts)
- Native mode (no Docker)
- Docker mode
- Several project folders
- Git worktree projects
- Problems
- Folders in the container
- Without the install script
- Develop keel v2