{
  "markdown": "# KotlinSense\n\n[![Version](https://img.shields.io/badge/version-1.0.0-blue)](.claude-plugin/plugin.json)\n[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)\n![Platform](https://img.shields.io/badge/platform-Claude%20Code-blueviolet)\n![Target](https://img.shields.io/badge/target-Kotlin%20%2F%20Android-brightgreen)\n\n> Kotlin code intelligence for Claude Code — automatic type checking, import resolution, null safety detection, and error diagnostics injected directly into Claude's context after every `.kt` file edit.\n\n**KotlinSense** is a Claude Code plugin that bridges `kotlin-language-server` into Claude's\ncontext, so Claude sees what the Kotlin compiler sees and fixes issues in the same turn —\nbefore they reach the build.\n\n## Table of Contents\n\n- [Overview](#overview)\n- [What It Does](#what-it-does)\n- [Installation](#installation)\n- [Quick Start](#quick-start)\n- [Commands](#commands)\n- [How It Works](#how-it-works)\n- [Plugin Structure](#plugin-structure)\n- [Requirements](#requirements)\n- [Troubleshooting](#troubleshooting)\n- [Documentation](#documentation)\n- [License](#license)\n- [About](#about)\n\n## Overview\n\nAI code generation for Kotlin without LSP context produces suggestions that compile but fail\nat runtime. Missing imports get suggested. Incorrect types get inferred. Null safety violations\nget introduced. The suggestions look plausible but are wrong in ways that only the Kotlin\ncompiler would catch.\n\nKotlinSense bridges `kotlin-language-server` into Claude Code's context. After every `.kt` file\nedit, real diagnostics — type errors, missing imports, null safety violations — are injected\nautomatically. Claude sees what the compiler sees and fixes issues in the same turn, before\nthey reach the build.\n\n## What It Does\n\n1. Connects Claude Code to `kotlin-language-server` via the Language Server Protocol\n2. After every `.kt` / `.kts` file edit, diagnostics are injected into Claude's context automatically\n3. Claude sees type errors, missing imports, and null safety violations — and fixes them in the same turn\n\nWorks for any Kotlin or Android developer. No project-specific config needed — just install the binary and go.\n\n## Installation\n\n**Step 1 — Add the marketplace**\n```bash\n/plugin marketplace add SUDARSHANCHAUDHARI/KotlinSense\n```\n\n**Step 2 — Install the plugin**\n```bash\n/plugin install kotlinsense\n```\n\nThen install the language server binary:\n\n```bash\n/kotlinsense:install\n```\n\nRequires Java 17+. Run `/kotlinsense:status` to verify.\n\n## Quick Start\n\n**1. Install the language server**\n```\n/kotlinsense:install\n```\nDownloads `kotlin-language-server` and adds it to your PATH. Requires Java 17+.\n\n**2. Verify it's working**\n```\n/kotlinsense:status\n```\nConfirms the binary, Java, and LSP connection are all ready.\n\n**3. Open a Kotlin project and start editing**\n\nOpen any `.kt` file and make an edit. KotlinSense automatically injects diagnostics into Claude's context — type errors, missing imports, null safety violations — and Claude fixes them in the same turn.\n\n## Commands\n\n| Command | Description |\n|---|---|\n| `/kotlinsense:install` | Download and install `kotlin-language-server` |\n| `/kotlinsense:status` | Check binary, Java, and LSP activation status |\n| `/kotlinsense:navigate` | Go-to-definition, find references, type inspection |\n\n## How It Works\n\n```\nClaude Code edits a .kt file\n    ↓\nkotlin-language-server analyzes the change (via LSP)\n    ↓\nDiagnostics injected into Claude's context\n    ↓\nClaude sees: \"error: Unresolved reference 'foo' at MainActivity.kt:42\"\n    ↓\nClaude fixes it immediately — same turn, no manual compile step\n```\n\nThe LSP connection is defined in `.lsp.json` and activates automatically when the plugin is enabled.\n\n## Plugin Structure\n\n```\nKotlinSense/\n├── .claude-plugin/\n│   ├── plugin.json              # Plugin manifest\n│   └── marketplace.json         # Marketplace manifest\n├── .lsp.json                    # LSP server config (.kt / .kts → kotlin-language-server)\n├── commands/                    # /kotlinsense:install|status|navigate\n├── scripts/\n│   ├── install-kotlin-ls.sh     # macOS / Linux installer\n│   ├── install-kotlin-ls.ps1   # Windows PowerShell installer\n│   └── verify-install.sh        # Binary + Java environment check\n├── skills/\n│   ├── kotlinsense-usage/       # How the plugin works, known limitations\n│   ├── kotlin-diagnostics/      # 10 common diagnostics with fixes\n│   └── kotlin-android-patterns/ # Idiomatic ViewModel, StateFlow, Compose, Hilt patterns\n├── README.md\n├── CHANGELOG.md\n└── LICENSE\n```\n\n## Requirements\n\n- [Claude Code](https://claude.ai/code) installed and authenticated\n- Java 17+ (`java -version` to check — install from [adoptium.net](https://adoptium.net/))\n- Internet connection for initial binary download (~50 MB)\n\n## Troubleshooting\n\n**Diagnostics not appearing after file edits**\nRun `/kotlinsense:status` to diagnose. Ensure `kotlin-language-server` is in PATH — restart terminal after install.\n\n**`kotlin-language-server: command not found`**\nRun `/kotlinsense:install`. Then check `$HOME/.local/bin` is in PATH: `echo $PATH`.\n\n**Slow startup (30–90 seconds on first open)**\nNormal — the server indexes the project on first open. Large Android projects take longer.\n\n**False positive errors on generated code (Room, Hilt, etc.)**\nRun `./gradlew build` first so annotation processors generate their output, then reopen the file.\n\n**Java not found**\nInstall Java 17+ from [adoptium.net](https://adoptium.net/). Verify: `java -version`.\n\n## Documentation\n\nFor full details — complete command walkthroughs, diagnostics reference, first-time setup guide, troubleshooting, and plugin architecture — see [DOCUMENTATION.md](DOCUMENTATION.md).\n\n- Kotlin Language Server: [github.com/fwcd/kotlin-language-server](https://github.com/fwcd/kotlin-language-server)\n- Privacy Policy: [github.com/SUDARSHANCHAUDHARI/kotlinsense-claude-plugin-privacy-policy](https://github.com/SUDARSHANCHAUDHARI/kotlinsense-claude-plugin-privacy-policy)\n- Issues: [github.com/SUDARSHANCHAUDHARI/KotlinSense/issues](https://github.com/SUDARSHANCHAUDHARI/KotlinSense/issues)\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n\n---\n\n## About\n\nI'm Sudarshan Chaudhari, a Senior Quality Engineer, Test Automation specialist, and AI systems builder based in Bangkok, Thailand.\n\nI have 13+ years of experience in software quality engineering, working across SaaS, fintech, gaming, web, mobile, cloud, and digital signage platforms. My background combines hands-on test automation with QA leadership, test strategy, CI/CD, release quality, production investigation, and cross-platform validation.\n\nAlongside my professional QA career, I run [SudarshanTechLabs](https://sudarshantechlabs.com/), my independent engineering and product lab where I design, build, test, and ship software across Android, web, AI, cybersecurity, developer tooling, and cross-platform applications.\n\n### What I work on\n\n- ⚙️ **Quality Engineering & Test Automation** — Playwright, Selenium, Cypress, Appium, API testing, automation frameworks, end-to-end testing, CI/CD, release gates, GitHub Actions, risk-based testing, and production validation\n- 🤖 **AI Systems & Automation** — AI agents, multi-agent orchestration, MCP servers, AI-assisted QA, prompt tooling, developer workflows, automation systems, and Claude Code plugins\n- 📱 **Mobile & Cross-Platform Applications** — Android applications built with Kotlin and Jetpack Compose, Google Play releases, automated build and publishing pipelines, and cross-platform development spanning iOS, web, Windows, and macOS\n- 🌐 **Web Applications & Platforms** — Full-stack applications using Next.js, TypeScript, Firebase, Cloudflare, REST APIs, and modern web infrastructure\n- 🛠️ **Developer Tooling & CLI Engineering** — Rust, Python, TypeScript, CLI utilities, multi-repository tooling, build automation, release tooling, and engineering productivity systems\n- 🛡️ **Cybersecurity & Observability** — Threat detection, log analysis, security auditing, vulnerability assessment, monitoring, and security-focused developer tools\n- 📺 **Digital Signage & Device Platforms** — Content validation, playback testing, device compatibility, production investigation, monitoring, and QA across diverse hardware and operating-system environments\n\nMy work sits at the intersection of quality engineering, automation, AI, and software development. I approach products with a QA mindset from the beginning: understanding failure modes, designing for testability, automating repetitive work, and building release confidence into the engineering process.\n\nThrough SudarshanTechLabs, I also build products and tools from idea to production, covering architecture, development, testing, CI/CD, release automation, monitoring, and ongoing maintenance.\n\n🌐 [sudarshantechlabs.com](https://sudarshantechlabs.com/) · 💼 [LinkedIn](https://linkedin.com/in/sudarshan-chaudhari) · 🐙 [GitHub](https://github.com/SUDARSHANCHAUDHARI) · ✉️ [sunny.sudarshan@gmail.com](mailto:sunny.sudarshan@gmail.com)\n",
  "bytes": 9030,
  "sha": "db3e530b66d567f25dc5f664f81f7daefb441f534f3189cad242145ad72ed90a",
  "repo_slug": "sudarshanchaudhari/kotlinsense",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_sudarshanchaudhari_kotlinsense_kotlinsen_2366ee48/readme"
}