Octocode: AI için Araştırma Odaklı Geliştirme

Tahmin Etmeyi Bırak. Bilmeye Başla.

AI asistanınızı Senior Staff Engineer'ın becerilerine sahip yap.

Kurulum

Ön Koşullar: GitHub kimlik doğrulaması gereklidir. Bkz. Authentication Setup.

Önerilen: Octocode CLI

npx octocode-cli install

GitHub OAuth, MCP server kurulumu ve skills marketplace'i içeren etkileşimli kurulum sihirbazı. Etkileşimsiz kurulum için --ide <ide> geçirin (ör. npx octocode-cli install --ide cursor).

Alternatif Yöntemler

Tek Tıklamayla Kurulum (Cursor)

Manuel MCP Yapılandırması

MCP yapılandırma dosyanıza ekleyin:

{
  "mcpServers": {
    "octocode": {
      "command": "npx",
      "args": ["octocode-mcp@latest"]
    }
  }
}

Research Skill (Doğrudan Kurulum)

npx add-skill https://github.com/bgauryy/octocode-mcp/tree/main/skills/octocode-research

MCP Server

Octocode MCP Server, AI asistanınızı koda bağlar:

GitHub, GitLab & Bitbucket: Repository'lerde ara, kullanım örüntülerini bul, implementasyonları oku, PR'ları/MR'ları keşfet
Yerel Araçlar: Kod ara (ripgrep), dizinlere göz at, yerel codebase'inde dosya bul
LSP Intelligence: Go to Definition, Find References, Call Hierarchy — compiler düzeyinde anlama
Package Discovery: npm/PyPI paketlerini kaynak repository'lerine çöz

https://github.com/user-attachments/assets/de8d14c0-2ead-46ed-895e-09144c9b5071

Paketler

Bu bir yarn-workspaces monorepo'sudur. Her paketin kendi README.md'si vardır; tüm kurulum/referans belgeleri docs/'da bulunur ve tüm AI agent rehberleri kök AGENTS.md dosyasında yer alır.

Paket	Amaç
`octocode-mcp`	MCP server — GitHub/GitLab/Bitbucket, yerel FS, LSP'de 14 araç
`octocode-cli`	CLI — installer, tool runner, skills marketplace
`octocode-vscode`	VS Code extension — GitHub OAuth + multi-editor MCP kurulum
`octocode-shared`	Paylaşılan utilities — credentials, session, platform
`octocode-security-utils`	Bağımsız güvenlik utilities

Skills

Agent Skills AI agent yeteneklerini genişletmek için hafif, açık bir formattır. Skills index: skills/README.md

Araştırma & Kod Analizi

Skill	Ne yaptığı
Researcher	Kod arama & keşfi — yerel LSP + harici (GitHub, npm/PyPI)
Research	Oturumlu, checkpoint'li, state kalıcılığı olan çok aşamalı araştırma
Engineer	Kodu anlama, yazma, analiz etme, audit etme — AST + LSP + dependency graph
Brainstorming	Kanıta dayalı fikir doğrulaması — GitHub, npm/PyPI, web paralel
News	AI, geliştirici araçları, web platform, güvenlik, önemli repo'lardaki yenilikler

Planlama & Yazı

Skill	Ne yaptığı
Plan	Kanıta dayalı planlama: Anlama > Araştırma > Plan > Uygulama
RFC Generator	Alternatifler, trade-off'lar ve önerilerle formal teknik kararlar
Doc Writer	16+'dan fazla doğrulanmış doc üreten 6 aşamalı pipeline
Prompt Optimizer	Zayıf prompt'ları uygulanabilir agent protokollerine dönüştür
Agentic Flow	MCP & multi-agent workflow tasarlanması/gözden geçirilmesi için düşünce çerçevesi

Gözden Geçirme & Eleştiri

Skill	Ne yaptığı
PR Reviewer	LSP flow tracing ile 7 alan genelinde PR & yerel kod gözden geçirmesi
Roast	Dosya:satır alıntıları ve önem seviyeleriyle acımasız kod eleştirisi

Derleme & Çıktı

Skill	Ne yaptığı
Slides	6 aşamalı tasarım akışı aracılığıyla cilalı multi-file HTML sunuları
Design	Görsel dil, bileşenler, a11y'i kapsayan dinamik DESIGN.md oluşturucu
Chrome DevTools	CDP düzeyinde tarayıcı debugging: network, console, perf, DOM, ekran görüntüleri

Araçlar & Kurulum

Skill	Ne yaptığı
Install	macOS ve Windows için etkileşimli adım adım Octocode installer'ı
CLI	MCP'yi bağlamadan terminalden Octocode MCP araçlarını çalıştır
Search Skill	Agent Skills'ı bul, değerlendir, kur, refactor et (SKILL.md formatı)
Stats	Octocode MCP kullanım istatistiklerinden yerel HTML panosu

https://github.com/user-attachments/assets/5b630763-2dee-4c2d-b5c1-6335396723ec

Belgeler

Tam index: docs/README.md. Tüm monorepo belgeleri docs/ klasöründe bulunur — paket başına docs/ yok.

Docs haritası

docs/configuration/ — kurulum, auth sağlayıcıları, MCP istemcileri, env/config, sorun giderme
docs/dev/ — tool/API referansları, iş akışları, mimari, katkı, skills
docs/specs/ — tasarım özellikleri ve RFC'ler

Kurulum

Authentication Setup · GitHub · GitLab · Bitbucket
Configuration Reference
Using octocode-mcp with Pi

Tool Referansları

CLI & Skills

Paylaşılan Dahiliyetler

Shared API Reference · Credentials Architecture · Session Persistence

İşlemler

Troubleshooting · Development Guide · Agent Guidance (AGENTS.md)

Manifesto

"Kod Gerçektir, Ancak Bağlam Haritadır." -- Octocode'un arkasındaki felsefesini anlamak için Araştırma Odaklı Geliştirme İçin Manifesto'yu okuyun.

Katkıda Bulunma

Monorepo kurulumu, test etme ve katkı yönergeleri için Development Guide bölümüne bakın.

_{AI Engineering Community için severek yapılmıştır}

bgauryy/octocode-mcp

Bu MCP sunucusu hakkında