Repository navigation
Develop keel v2
Milimarty edited this page Oct 19, 2026
·
2 revisions
| Part | Tech | Run | Tests |
|---|---|---|---|
engine/ |
Python 3.12, FastAPI, LangGraph, LangChain, MCP |
uv run keel-engine (:8090) |
uv run pytest |
api/ |
Kotlin, Spring Boot 3, SQLite, Flyway |
./gradlew bootRun (:8080) |
./gradlew test |
web/ |
React, TypeScript, Vite |
npm run dev (:5173) |
npm test |
cli/ |
keel TUI: TypeScript, Ink, esbuild |
npm run build, then KEEL_TUI_JS=cli/dist/keel-tui.mjs keel2 tui
|
npm test |
How the parts talk: CONTRACT.md.
docker build -t keel-v2 . # everything is installed in the image
docker build --build-arg INSTALL_CLIS=0 -t keel-v2:slim . # without the agent CLIs
npx -y -p playwright@1 node docs/gif/record.js # record the README's GIF from a running keel
scripts/no-v1.sh # lists anything that still depends on keel v1 (CI: 0)A version tag (v*) builds amd64 + arm64 images (on GitHub's Intel and ARM machines at the same time) and pushes them
to ghcr.io/miladnalbandi/keel-v2 (and to Docker Hub when the DOCKERHUB_USERNAME and DOCKERHUB_TOKEN secrets are
set). Dependabot (.github/dependabot.yml) opens a pull request every week for each part's dependencies, the Docker
base images and the GitHub Actions.
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