Repository navigation
Problems
Milimarty edited this page Oct 19, 2026
·
2 revisions
Run keel2 doctor first. The most common ones:
| You see | Do this |
|---|---|
| "Docker is not running" | start Docker Desktop (keel2 starts it on a Mac) |
| "not a git repository" | say yes when keel2 offers git init; for a git worktree, see Git worktree projects
|
| port 8080 is busy | nothing: keel2 uses the next free port and tells you |
| an agent "is not logged in" | Connections › Set up login |
| your tests start containers | keel2 start --docker <folder> |
| "Sign in to keel" in the browser | keel2 open |
| copying in keel TUI does nothing (macOS Terminal) |
/mouse off, then select |
All commands: keel2 help (logs, tokens, backup, restore, uninstall …).
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