Synaptic Code Intelligence

Synaptic

コーディングアシスタントに、ファイルの山ではなくコードベースの地図を。

Synaptic はリポジトリを一度マッピングするので、あなたもコーディングアシスタントも、セッションのたびにリポジトリを再発見する必要はありません。システムがどのように動作するのか、あるシンボルに何が依存しているのか、ある変更が何を壊す可能性があるのかを尋ねてください。答えは、永続的でソースに基づいたナレッジグラフから得られます。コマンドラインからでも、MCP を通じてでも利用できます。Synaptic は過去の変更を記憶し、小さくレビュー可能な API と依存関係の修復を計画することもできます。

コードの抽出はローカルかつ決定的です。Synaptic はランタイム、データベース、アカウント、API キーを必要としない、単一の Rust バイナリとして提供されます。

ドキュメント | クイックスタート | ベンチマーク | Discord

はじめに

チェックサム付きの最新リリースをインストールします:

# macOS / Linux
curl --proto '=https' --tlsv1.2 -LsSf https://raw.githubusercontent.com/ColinVaughn/Synaptic/main/install.sh | sh

# Windows PowerShell
irm https://raw.githubusercontent.com/ColinVaughn/Synaptic/main/install.ps1 | iex

次に、リポジトリ内で Synaptic を実行します:

synaptic extract .                         # build synaptic-out/graph.json
synaptic query "how does authentication work?"
synaptic affected parse_config             # what could this change break?

抽出は .gitignore と .synapticignore に従い、一般的なシークレットファイルをスキップし、ネットワークを利用する機能を明示的に有効にしない限りオフラインのままです。

コーディングアシスタントを接続する

synaptic install claude                    # Claude Code
synaptic install codex                     # Codex CLI
synaptic install codex --global            # Codex desktop app

Claude と Codex は起動時に少数のツールだけを読み込み、残りは必要に応じて検索します。これにより、機能を隠すことなくプロンプトを小さく保てます。Gemini、Cursor、Copilot、OpenCode、Kilo、および汎用的な AGENTS.md クライアントもサポートされています。詳しくは アシスタント統合 を参照してください。

できること

ニーズ	Synaptic が提供するもの
コードを理解する	シンボル、呼び出し、インポート、継承、リソース、SQL、言語をまたぐ境界を 1 つのグラフに
影響範囲を見つける	呼び出し元、参照、逆依存関係、動的ディスパッチの危険、影響を受けるテスト
安全にコードを変更する	変更予測、リファクタリング計画、アーキテクチャの差分、分離されたワークツリーでの任意の検証
過去を記憶する	コミット、意思決定、インシデント、レビュー、CI、過去の試行からのソースに紐づいた履歴
依存関係を維持する	API コントラクトの追跡と脆弱性の証跡、および小さくレビュー可能な修復ワークフロー

Synaptic は数十の言語、増分更新、マルチリポジトリのフェデレーション、構造検索、SQL 監査、グラフを考慮した PR レビュー、および GraphML、Cypher、Graphviz、Obsidian、Markdown へのエクスポートをサポートしています。詳細な機能は ドキュメント に記載されており、このページははじめかたに焦点を当てています。

アーキテクチャを見る

synaptic chart

これにより、グラフから自己完結型のアーキテクチャマップが作成されます。サブシステムを開き、シンボルを選択し、サーバーなしでその実際の受信および送信の関係をたどることができます。

コンテキストを節約するために作られています

Synaptic は、ソースファイル全体をアシスタントのコンテキストに読み込む代わりに、グラフの関連するスライスを返します。チェックインされたトークンベンチマークでは、完全なグラフの回答は、それらの回答が参照するソースファイルを読む場合よりも 27～38 倍少ないトークンで済みました。これはコンテキスト圧縮の測定値であり、タスク全体のコストに関する約束ではありません。手法と生の結果は BENCHMARKS.md にあります。

よく使うコマンド

コマンド	目的
synaptic extract .	グラフを構築します
synaptic update / synaptic watch	最新の状態に保ちます
synaptic query "..."	質問に関連するサブグラフを検索します
synaptic affected <symbol>	逆方向の影響を追跡します
synaptic predict <files>	リスクを予測し、テストを選択します
synaptic speculate <files>	使い捨てのワークツリーで変更を検証します
synaptic memory search "..."	関連するリポジトリ履歴を検索します
synaptic serve	MCP サーバーを実行します

フラグについては synaptic <command> --help を実行するか、完全な コマンドリファレンスをご利用ください。

ワークフローを選ぶ

• CLI: ローカルでの抽出、クエリ、自動化、MCP に最適な最短の方法です。
• デスクトップ: synaptic-ui を実行すると、リポジトリの視覚的なセットアップ、フェデレーション、アシスタント 接続、更新、および完全なコマンドカタログを利用できます。
• ホステッド: Synaptic Cloud はマネージド MCP サービスを提供します。 コミットをトリガーとするグラフ同期と検証済みの修復ワークフローについては、 GitHub 自動化ガイドをご覧ください。

リリース版のインストールは synaptic self-update で更新します。

ドキュメント

• インストールと クイックスタート
• クエリ、 言語、 出力形式
• MCP サーバーと アシスタント統合
• リポジトリメモリ、 API メンテナンス、 脆弱性管理
• ワークスペースとフェデレーション、 設定、 開発

ソースからビルドする

このリポジトリは Rust 1.97.1 を固定しています。

cargo install --path bin/synaptic
cargo install --path bin/synaptic-ui       # optional desktop app

開発とアーキテクチャに関する注意事項については、 開発ガイドをご覧ください。

コミュニティとライセンス

質問、アイデア、あるいは何か作ったものがありますか? Discord コミュニティにご参加ください。

Synaptic は AGPL-3.0-or-later の下でライセンスされています。詳しくは LICENSE と NOTICE をご覧ください。 Synaptic を改変し、ネットワーク経由で利用可能にした場合、それらのユーザーに対応する ソースを提供する必要があります。別途メンテナンスされている Synaptic Cloud サービスはプロプライエタリであり、 このリポジトリのライセンスの対象外です。