Menu
Instructions for debugging adk-server during development
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Wraps existing Python agent as Kagenti ADK service using kagenti-adk with minimal compatibility changes and no business-logic rewrites. Use when migrating, wrapping, or deploying an existing plain Python or framework-based agent to Kagenti ADK; not for non-Python runtimes or building new agent from scratch.
Creates custom TypeScript UIs for Kagenti ADK agents using the @kagenti/adk SDK and A2A protocol. Use when building a custom frontend, chat interface, or interactive UI for an existing Kagenti ADK agent; not for wrapping Python agents or building agents themselves.
Helps generate release notes to be published on GitHub as well as in a Slack community channel
Draft GitHub issues for kagenti/adk. Use when the user wants to report a bug, request a feature, or draft a general GitHub issue.
| name | adk-server-debugging |
| description | Instructions for debugging adk-server during development |
ADK server runs in a Kubernetes cluster inside a Lima VM. For local development, the server runs on your machine with Telepresence routing cluster traffic to it.
Run mise run dev:ensure to start everything needed for server development. This is idempotent โ safe to run repeatedly. It will:
Check status anytime with mise run dev:status.
.env ConfigurationThe server reads from apps/adk-server/.env. If it doesn't exist, copy from template.env:
cp apps/adk-server/template.env apps/adk-server/.env
Template defaults work for development. For running tests, add:
DB_URL=postgresql+asyncpg://adk-user:password@localhost:5432/adk
| Action | Command |
|---|---|
| Ensure dev env is ready | mise run dev:ensure |
| Check environment status | mise run dev:status |
| Run server manually (if not via dev:ensure) | mise run adk-server:run |
| Run a specific test | cd apps/adk-server && uv run pytest -k 'test_name' |
| Run CLI | mise run adk-cli:run -- <command> |
| Stop local processes (keep VM) | mise run dev:stop |
~/.kagenti/adk/logs/adk-server.log for errors.mise run dev:stop then mise run dev:ensure to reconnect.mise run dev:stop kills processes on ports 18333, 3000, 5432, 6379.