Graphicle-AI/graphicle

选用指南

AI 根据 README 整理 · 2026/10/22 14:06:32

适用场景

适用于需要给编码代理提供代码图和项目记忆的场景，如快速找到失败请求重试的位置或了解代码结构。

查看 README 依据

capture, adds a two-line section to `AGENTS.md` (unless Claude Code is the only agent) and installs Git hooks that keep the project current. It lists every file it changes and backs each one up first; `graphicle disconnect` undoes it all. Then ask your agent to *"use graphicle to find where failed requests are retried"*, or ask from the terminal: ```console $ graphicle ask "where is tax added to prices?" Evidence for "where is tax added to prices?" 4 excerpts · 598 of 3,000 tokens [1] shop/pricing.py:1-7 price_with_tax() """Prices and tax.""" TAX_RATE = 0.2

rails 0.77×, spring-boot 0.94×. Lower in all 39 measurements, at 0.29× to 0.97× of Graphify's peak, on a pre-release memory build whose graphs differ from Graphify's; Graphicle's peak RSS or PSS, whichever is larger, against Graphify's peak PSS. A build of the merged 0.1.1 source stayed below in the 5 measurements rechecked. Speed and memory tables and method: docs/benchmarks.md." width="860"> </picture> </p> ## What it does - **Code graph.** Files, functions, classes, calls and imports, parsed with tree-sitter and no model. `graphicle graph` searches it, explains a symbol,

目标用户

面向使用 Claude Code、Codex、Cursor 等编码代理的开发者。

查看 README 依据

Graphicle maps your repository into a code graph, remembers your project's docs, decisions and past agent sessions, and gives your coding agent cited excerpts from both: the exact files and lines. It runs on your machine: no API key needed, no account, <a href="#privacy-and-local-first">no telemetry</a>.<br> _{Works with Claude Code · Cursor · Codex · VS Code · Claude Desktop · any MCP client} </p> <p align="center">

使用方式

通过命令行使用，支持 setup、ask、open、graph extract 等子命令，并可为 MCP 客户端提供工具。

查看 README 依据

<img src="assets/hero.gif" alt="A terminal in four steps. graphicle setup syncs a small repository, builds its code graph, finds five agent clients, connects them and lists every file it changed. graphicle ask returns four cited excerpts, the first shop/pricing.py lines 1 to 7, price_with_tax(). After an edit, graphicle context syncs the changed file before answering. graphicle doctor shows 18 checks passing and one warning: no answer model is set." width="860"> </p> ## Quick start ```sh brew install graphicle-ai/tap/graphicle cd your-repo graphicle setup ```

`curl -fsSL https://github.com/graphicle-ai/graphicle/releases/latest/download/install.sh | sh`), then run `graphicle setup --yes` in this repository and list every file it changed. ``` </details> ## Start here | You want to | Run | |---|---| | Give your coding agent the code graph and your project's memory | `graphicle setup` in the repository | | Ask a question from the terminal | `graphicle ask "how are failed requests retried?"` | | Browse the graph, the sources and the memory | `graphicle open` |

部署要求

支持 macOS、Linux 和 Windows（预览版），无 API 密钥或账户要求，但 ask 等功能的完整回答需要配置模型。

查看 README 依据

<a href="https://github.com/graphicle-ai/graphicle/releases/latest"><img alt="Latest release" src="https://img.shields.io/github/v/release/graphicle-ai/graphicle?color=3D5AFE"></a> <img alt="Platforms: macOS, Linux and Windows (preview)" src="https://img.shields.io/badge/platforms-macOS%20%7C%20Linux%20%7C%20Windows%20%28preview%29-3D5AFE"> <a href="https://discord.com/invite/rWuU7cWU4E"><img alt="Chat on Discord" src="https://img.shields.io/badge/chat-Discord-3D5AFE?logo=discord&amp;logoColor=white"></a> </p> <p align="center">

- **Careful sync.** `sync` respects `.gitignore` and skips `.env` files, keys and credentials. Session capture drops `<private>…</private>` spans and redacts credentials. - **Forgetting with a receipt.** Deleting a memory or a captured session also removes what was derived from it, and you get a hash-chained deletion receipt. <details> <summary><b>Do I need an API key or a model?</b></summary> No, for most of it. The code graph (with `--code-only`), sync, `context`, the MCP server, session capture and the app work without one.

A model writes the answers of `graphicle ask`, proposes memories from sources and reads documents and images in a full `graphicle graph extract`. Local models through Ollama or any OpenAI-compatible server work ([configuration](docs/configuration.md#models)). </details> <details> <summary><b>Is Graphicle a fork of Graphify?</b></summary>

已知限制

项目默认支持最多 100,000 个文本文件和 1 GiB 文本，大文件可能只部分分析；会话记忆的长会话和累积记忆尚未测试。

查看 README 依据

<summary><b>Will it handle my large repository?</b></summary> By default a project can hold up to 100,000 text files and 1 GiB of text; you can raise both (see [Limits in docs/configuration.md](docs/configuration.md#limits)). A very large file is analysed in part or kept as searchable text instead of stopping a sync. </details> <details> <summary><b>Is there a version for teams?</b></summary> Graphicle is free and open source under Apache-2.0, for individuals and teams alike. A commercial edition for teams is in private preview.

Every figure is labelled, and [docs/benchmarks.md](docs/benchmarks.md) has the full tables, methods and limits. In the agent tests, a difference counts only when its 95% interval excludes 0; otherwise it is a tie. Long sessions and memory built up across coding sessions are not tested yet. <p align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="assets/graphicle-011-hero-dark.svg">