Code Hologram

English · Türkçe

Explains what every line of code does, using AI, and shows it over your editor like a hologram. Nothing is ever written to your file.

This is not a comment translator. Those translate comments that already exist, so when there are no comments they have nothing to work with. Code Hologram generates the explanation from the code itself.

function calc(a, b) {          takes two numbers
  let t = a * 0.18;            computes 18% of a as tax
  return a + t + b;            returns amount + tax + b
}

The faint text on the right is not in the file. It does not vanish when you save, because it was never written in the first place. It never shows up in git diff, the compiler never sees it, and it is not copied along with the code.

Install

Open the Extensions panel with Ctrl+Shift+X, search for Code Hologram and install. Or from a terminal:

code --install-extension poltka.kod-hologram

The identifier keeps the original Turkish spelling, kod-hologram, because a published extension ID can never be changed. The displayed name is Code Hologram, and Kod Hologram in Turkish.

Then run Code Hologram: Set up the AI engine from the Command Palette (Ctrl+Shift+P). The wizard probes your environment and puts whichever engine is actually available first, with the address and model filled in for you. After that, press Ctrl+Alt+H in any code file.

The extension hosts no AI service of its own. It uses your existing Copilot subscription, your own API key, or a model running on your machine. Pick a local model and your code never leaves the device.

Explanation language

Explanations are written in your language, not only English. The display language of VS Code is resolved automatically and 41 languages are mapped. You can also name any language as free text with the kodHologram.language setting: English, Türkçe, 日本語, العربية, Português do Brasil.

Source languages

There is no restriction. Hover and commands are registered for every file type. Python, Go, Rust, SQL, Bash, HTML, YAML, Dockerfile, it makes no difference. The file's language is passed to the model, which explains using that language's own concepts, such as list comprehension in Python or ownership in Rust, but in plain words. In configuration and markup files it explains what each line configures.

How it appears

• End-of-line ghost text, a short summary in faint italics to the right of your code.
• Hover, a detailed explanation in a bubble when you point at a line.

Either can be turned off on its own with kodHologram.ghostText.enabled and kodHologram.hover.enabled.

Commands

The hologram clears the moment you edit the code, since line numbers shift and stale explanations would point at the wrong lines.

Command names follow the display language of VS Code. They are translated into English, Turkish, German, French, Spanish, Italian, Portuguese, Russian, Japanese, Korean, Chinese and Polish; any other display language falls back to English.

Choosing an AI engine

The kodHologram.provider setting takes four values.

local — a local server, or any OpenAI-compatible cloud endpoint

The name says local, but it works with any OpenAI-compatible endpoint. Local: Ollama, LM Studio, llama.cpp, Jan, vLLM. Cloud: Google Gemini, OpenAI, Groq, OpenRouter, DeepSeek.

For Gemini, which has a free tier:

"kodHologram.provider": "local",
"kodHologram.local.baseUrl": "https://generativelanguage.googleapis.com/v1beta/openai",
"kodHologram.local.model": "gemini-flash-latest"

Do not put a cloud API key in your settings. Run Code Hologram: Set the OpenAI-compatible API key and it goes into secure storage instead.

For Ollama:

"kodHologram.provider": "local",
"kodHologram.local.baseUrl": "http://localhost:11434/v1",
"kodHologram.local.model": "qwen2.5-coder:14b"

LM Studio usually listens on http://localhost:1234/v1.

Model choice matters. Models at 7B and below break the line-by-line JSONL format, and since the parser skips malformed lines, some explanations go missing. A 14B or larger code model is recommended. On local hardware long output is slow, so dropping kodHologram.maxLines to somewhere around 40-60 makes it feel noticeably smoother.

copilot — VS Code Language Model API

Uses the GitHub Copilot subscription you already have. No API key needed. VS Code shows its own consent dialog on the first request. kodHologram.copilotFamily pins a model family; leave it empty and the first available model is used.

anthropic — Anthropic API

Run Code Hologram: Set the Anthropic API key to enter your key. It is kept in VS Code SecretStorage and is never written to settings.json, so it cannot be committed by accident. The ANTHROPIC_API_KEY environment variable is read as well.

The default model is claude-opus-5 with effort set to low, which keeps the hologram feeling instant. For dense code, try raising kodHologram.effort to medium.

auto (default)

Anthropic if a key is present, otherwise Copilot. A local model has to be selected explicitly.

Settings

autoExplain is off by default, because every refresh is another AI request and, on paid providers, another charge.

How it works

Instead of one large JSON response, the model emits one JSON object per line. Explanations therefore land on screen one at a time as the model writes them, which is where the instant feel comes from. The parser is forgiving: it quietly skips markdown code fences, blank lines and malformed fragments, so one bad line does not take the rest down with it.

License

Proprietary. Copyright (c) 2026 Poltka. All rights reserved.

You may install and use the extension on as many devices as you like, for personal or commercial work. Copying, modifying, republishing or selling the code requires written permission. Full terms are in the LICENSE file inside the extension package.

The extension hosts no AI service of its own; it sends code to the provider you choose. That choice, the data sent and any charges are yours. With a local model, code never leaves your machine.

Kod Hologram (Türkçe)

English · Türkçe

Kodda yorum olmasa bile, her satırın ne yaptığını AI ile açıklayıp editörün üstünde hologram gibi gösterir. Kaynak dosyaya hiçbir şey yazmaz.

Mevcut "yorum çevirici" eklentilerinden farkı: onlar var olan yorumu çevirir, yorum yoksa çevirecek bir şey bulamaz. Bu eklenti açıklamayı kodun kendisinden üretir.

function calc(a, b) {          iki sayı alan fonksiyon
  let t = a * 0.18;            a'nın %18'ini KDV olarak hesaplar
  return a + t + b;            tutar + KDV + b'yi toplayıp döndürür
}

Sağdaki soluk yazılar dosyada yok. Kaydedince kaybolmaz çünkü zaten hiç yazılmadı; git diff'e düşmez, derleyici görmez, kopyalanmaz.

Kurulum

VS Code içinde Ctrl+Shift+X ile eklentiler panelini aç, Kod Hologram ara ve kur. Ya da komut satırından:

code --install-extension poltka.kod-hologram

Kurduktan sonra ilk iş olarak komut paletinden (Ctrl+Shift+P) Kod Hologram: Motoru ayarla komutunu çalıştırın. Sihirbaz ortamınızı yoklar ve kullanılabilir motoru hazır ayarlarla öne alır. Sonra bir kod dosyasında Ctrl+Alt+H.

Eklenti kendi AI servisini barındırmaz; mevcut Copilot aboneliğinizi, kendi API anahtarınızı ya da makinenizdeki yerel modeli kullanır. Yerel model seçerseniz kod makineden hiç çıkmaz.

Diller

Dil kısıtı yoktur; hover ve komutlar tüm dosya türlerine kayıtlıdır. Python, Go, Rust, SQL, Bash, HTML, YAML, Dockerfile fark etmez. Dosyanın dili modele bildirilir ve o dilin kendi kavramlarıyla, Python'da "liste üreteci", Rust'ta "sahiplik" gibi, ama sadeleştirilerek anlatılır. Yapılandırma ve işaretleme dosyalarında satırın neyi ayarladığı açıklanır.

Açıklamalar VS Code'un görüntü dilinde yazılır, 41 dil eşlendi. Serbest metinle başka diller de yazılabilir.

Nasıl görünür

• Satır sonu hayalet yazı, kısa özet, kodun sağında soluk italik.
• Hover, fareyi satırın üstüne getirince detaylı açıklama baloncukta.

İkisi de ayrı ayrı kapatılabilir: kodHologram.ghostText.enabled, kodHologram.hover.enabled.

Kullanım

Kodu düzenlediğiniz anda hologram temizlenir, çünkü satır numaraları kaydığı için eski açıklamalar yanıltıcı olurdu.

AI motoru seçimi

kodHologram.provider ayarı dört değer alır.

En kolay başlangıç: Kod Hologram: Motoru ayarla komutunu çalıştırın. Sihirbaz ortamınızı yoklar, Copilot var mı, Ollama ayakta mı bakar, kullanılabilir olanı başa alır ve adresi ile modeli sizin yerinize doldurur.

local — yerel sunucu veya OpenAI uyumlu bulut servisi

Adı "local" ama OpenAI uyumlu her uçla çalışır. Yerel: Ollama, LM Studio, llama.cpp, Jan, vLLM. Bulut: Google Gemini, OpenAI, Groq, OpenRouter, DeepSeek.

Gemini için, ücretsiz katmanı var:

"kodHologram.provider": "local",
"kodHologram.local.baseUrl": "https://generativelanguage.googleapis.com/v1beta/openai",
"kodHologram.local.model": "gemini-flash-latest"

Bulut anahtarını ayara yazmayın; Kod Hologram: OpenAI uyumlu API anahtarını ayarla komutu onu güvenli depoya koyar.

Ollama için:

"kodHologram.provider": "local",
"kodHologram.local.baseUrl": "http://localhost:11434/v1",
"kodHologram.local.model": "qwen2.5-coder:14b"

LM Studio için adres genelde http://localhost:1234/v1 olur.

Model seçimi önemli. 7B ve altı modeller satır satır JSONL biçimini bozar; ayrıştırıcı bozuk satırları atladığı için bazı açıklamalar eksik kalır. 14B+ bir kod modeli önerilir. Yerel donanımda uzun çıktı yavaş olduğundan kodHologram.maxLines değerini 40-60 civarına düşürmek akıcılığı belirgin biçimde artırır.

copilot — VS Code Language Model API

Mevcut GitHub Copilot aboneliğinizi kullanır. API anahtarı gerekmez; ilk istekte VS Code kendi izin diyaloğunu gösterir. kodHologram.copilotFamily ile model ailesi sabitlenebilir, boş bırakılırsa ilk uygun model seçilir.

anthropic — Anthropic API

Kod Hologram: Anthropic API anahtarını ayarla komutuyla anahtarı girin. Anahtar VS Code'un güvenli deposunda tutulur, settings.json'a yazılmaz, yani yanlışlıkla depoya commit edilmez. Alternatif olarak ANTHROPIC_API_KEY ortam değişkeni de okunur.

Varsayılan model claude-opus-5, effort değeri low, hologramın anlık hissi için. Karmaşık kodlarda kodHologram.effort ayarını medium yapmayı deneyin.

auto (varsayılan)

Anthropic anahtarı varsa Anthropic, yoksa Copilot. Yerel model için local değerini açıkça seçmek gerekir.

Ayarlar

autoExplain varsayılan olarak kapalıdır: her yenileme bir AI isteği, ücretli sağlayıcılarda ise ücret demektir.

Nasıl çalışır

Model, tek bir büyük JSON yanıtı yerine satır başına bir JSON nesnesi üretir. Böylece açıklamalar model yazdıkça teker teker ekrana düşer; hologramın "anlık" hissi buradan gelir. Ayrıştırıcı hoşgörülüdür: markdown kod çitlerini, boş satırları ve bozuk parçaları sessizce atlar, bir satır bozulsa bile diğerleri görünmeye devam eder.

Lisans

Özel mülk yazılım. Telif hakkı (c) 2026 Poltka. Tüm hakları saklıdır.

Eklentiyi dilediğiniz kadar cihaza kurup kişisel veya ticari işlerinizde kullanabilirsiniz. Kodu kopyalamak, değiştirmek, yeniden yayınlamak veya satmak yazılı izne bağlıdır. Tam koşullar eklenti paketindeki LICENSE dosyasındadır.

Eklenti kendi AI servisini barındırmaz; seçtiğiniz sağlayıcıya kod gönderir. Sağlayıcı seçimi, gönderilen veri ve doğacak ücretler size aittir. Yerel model seçerseniz kod cihazınızdan hiç çıkmaz.