Menu
Instructions for debugging adk-server during development
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
| 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.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.