{
  "markdown": "# ix-gemini-plugin\n\nA Gemini CLI extension that turns Gemini into a graph-reasoning engineering agent using [Ix Memory](https://github.com/ix-infrastructure/Ix) as its structured memory backend.\n\nGemini + Ix = reasoning engine + persistent code knowledge graph. Skills are cognitive abstractions, not CLI wrappers.\n\n## Requirements\n\n- [Ix Memory](https://github.com/ix-infrastructure/Ix) installed and running (`ix status` returns ok)\n- `python3` in PATH for hook scripts\n- `ripgrep` (`rg`) is recommended\n\nIx Pro is optional. If present, the `BeforeAgent` hook injects the Ix session briefing once per 10 minutes.\n\n## Skills\n\nHigh-level cognitive skills:\n\n| Skill | What it does | Key rule |\n|-------|--------------|----------|\n| `ix-help <task or question>` | Route to the right Ix skill or direct `ix` command | Route only; do not execute |\n| `ix-understand [target]` | Build a mental model of a system or the whole repo | Graph only; no code reads |\n| `ix-investigate <symbol>` | Deep dive: what it is, how it connects, execution path | Graph first; one symbol read max |\n| `ix-impact <target>` | Change risk: blast radius, affected systems, test targets | Depth scales with risk |\n| `ix-plan <targets...>` | Risk-ordered implementation plan for a set of changes | Parallel impact; finds shared dependents |\n| `ix-debug <symptom>` | Root cause analysis from symptom to candidates | Minimal source reads at suspects only |\n| `ix-architecture [scope]` | Design health: coupling, smells, hotspots | Graph only; never reads source |\n| `ix-docs <target> [--full]` | Generate narrative-first documentation with selective reference | Default is onboarding-focused |\n\n## Agent Playbooks\n\nReusable playbook docs in [`agents/`](./agents):\n\n| Playbook | Purpose |\n|----------|---------|\n| `ix-explorer` | General-purpose graph exploration |\n| `ix-system-explorer` | Full architectural model of a codebase or region |\n| `ix-bug-investigator` | Root cause analysis from symptom to candidates |\n| `ix-safe-refactor-planner` | Blast radius plus safe change sequencing |\n| `ix-architecture-auditor` | Structural health report with ranked improvements |\n\n## Automatic Hooks\n\n| Trigger | Gemini hook | Effect |\n|---------|-------------|--------|\n| Session starts | `SessionStart` | Injects Ix operating guidance and graph-first rules |\n| Before agent plans | `BeforeAgent` | Injects `ix briefing` once per 10 min if Ix Pro is available |\n| Before shell tool | `BeforeTool` | Front-runs `grep`/`rg`/`cat`/`head` with `ix text` + `ix locate` context |\n| After shell tool | `AfterTool` | Triggers background `ix map` after file-modifying shell commands |\n| Session ends | `SessionEnd` | Runs `ix map` asynchronously to refresh the graph |\n\n## Install\n\n### Quick install\n\n```bash\ngemini extensions install /path/to/ix-gemini-plugin\n```\n\nOr from GitHub:\n\n```bash\ngemini extensions install https://github.com/ix-infrastructure/ix-gemini-plugin\n```\n\n### Manual install\n\n```bash\ngit clone git@github.com:ix-infrastructure/ix-gemini-plugin.git\ncd ix-gemini-plugin\n./install.sh\n```\n\nThe installer copies the extension to `~/.gemini/extensions/ix-memory/`.\n\nOn Windows PowerShell:\n\n```powershell\n.\\install.ps1\n```\n\n### Repo-local install\n\n```bash\n./install.sh --repo /path/to/project\n```\n\nThis copies the extension to `/path/to/project/.gemini/extensions/ix-memory/`.\n\nPowerShell equivalent:\n\n```powershell\n.\\install.ps1 -Repo C:\\path\\to\\project\n```\n\n## Local Validation\n\nRun the local MCP build and test path with:\n\n```bash\n./test-local.sh\n```\n\nThis covers the local MCP server surface and skips live Gemini CLI validation when `gemini` is not installed.\n\n## Repo Guidance\n\nThe repo-level operating guide lives in [`GEMINI.md`](./GEMINI.md). It carries the graph-first reasoning model, skill reference, and token-budget rules.\n",
  "bytes": 3803,
  "sha": "04c7f2113d696e2fd4989cac27419c09c7b7f78e12599a042598d54843972908",
  "repo_slug": "ix-infrastructure/ix-gemini-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_ix_infrastructure_ix_gemini_plugin_8a7951e9/readme"
}