debug-instance

Solid

Debug a running kandev development instance. Use when the user reports a bug, unexpected behavior, or asks to investigate an issue while kandev is running via `make dev`. Fetches backend logs, analyzes errors, and optionally inspects the UI via an existing Playwright browser session.

Code & Development 276 stars 29 forks Updated today AGPL-3.0

Install

View on GitHub

Quality Score: 88/100

Stars 20%
81
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Debug Running Kandev Instance Diagnose issues in a running kandev development instance by fetching structured logs and optionally inspecting the UI via an existing Playwright browser session. ## Immediately: Create Task Pipeline As soon as this skill is invoked, create a task list to track progress: 1. **Detect running instance** — probe health endpoint, determine ports 2. **Fetch & analyze backend logs** — get debug export, summarize errors 3. **Browser inspection** (if UI-related) — check for existing playwright session, inspect DOM/console 4. **Diagnose & report** — correlate findings, present root cause hypothesis Mark each task as `in_progress` when starting and `completed` when done. Skip task 3 if the issue is purely backend. --- ## Phase 1 — Detect Running Instance 1. Probe the default backend port: ```bash curl -sf http://localhost:38429/api/v1/system/health ``` 2. If that fails, try ports 38430–38435 (kandev auto-assigns nearby ports if default is busy). 3. If still not found, ask the user which port kandev is running on. 4. Derive the web port: typically `backend_port - 1000` (e.g., 38429 → 37429). ## Phase 2 — Fetch & Analyze Logs **IMPORTANT**: The debug export returns raw JSON. If output appears schema-converted (types instead of values), the response is being compressed by a proxy tool — use `curl` directly or check tool configuration. 1. Fetch the debug export: ```bash curl -s http://localhost:<backend_port>/api/v1/system/debug/expo...

Details

Author
kdlbs
Repository
kdlbs/kandev
Created
4 months ago
Last Updated
today
Language
Go
License
AGPL-3.0

Integrates with

Related Skills

Code & Development Featured

code-reviewer

Analyzes code diffs and files to identify bugs, security vulnerabilities (SQL injection, XSS, insecure deserialization), code smells, N+1 queries, naming issues, and architectural concerns, then produces a structured review report with prioritized, actionable feedback. Use when reviewing pull requests, conducting code quality audits, identifying refactoring opportunities, or checking for security issues. Invoke for PR reviews, code quality checks, refactoring suggestions, review code, code quality. Complements specialized skills (security-reviewer, test-master) by providing broad-scope review across correctness, performance, maintainability, and test coverage in a single pass.

9,342 Updated 5 days ago
Jeffallan
Code & Development Featured

security-reviewer

Identifies security vulnerabilities, generates structured audit reports with severity ratings, and provides actionable remediation guidance. Use when conducting security audits, reviewing code for vulnerabilities, or analyzing infrastructure security. Invoke for SAST scans, penetration testing, DevSecOps practices, cloud security reviews, dependency audits, secrets scanning, or compliance checks. Produces vulnerability reports, prioritized recommendations, and compliance checklists.

9,342 Updated 5 days ago
Jeffallan
Code & Development Featured

parallel-investigation

Coordinates parallel investigation threads to simultaneously explore multiple hypotheses or root causes across different system areas. Use when debugging production incidents, slow API performance, multi-system integration failures, or complex bugs where the root cause is unclear and multiple plausible theories exist; when serial troubleshooting is too slow; or when multiple investigators can divide root-cause analysis work. Provides structured phases for problem decomposition, thread assignment, sync points with Continue/Pivot/Converge decisions, and final report synthesis.

745 Updated 1 months ago
rohitg00