@kentwynn/kgraph 0.1.19 → 0.1.20

package/README.md

@@ -2,7 +2,7 @@
 
 Persistent repository intelligence for AI coding tools.
 
-KGraph gives Codex, GitHub Copilot, Cursor, and Claude Code a local knowledge layer for your repo: file maps, symbols, imports, relationships, and durable notes from previous AI sessions. The goal is simple: your assistant should not spend every session re-learning the same codebase.
+KGraph gives Codex, GitHub Copilot, Cursor, Claude Code, Gemini CLI, Windsurf, and Cline a local knowledge layer for your repo: file maps, symbols, imports, relationships, and durable notes from previous AI sessions. The goal is simple: your assistant should not spend every session re-learning the same codebase.
 
 ## The Workflow
 
@@ -10,7 +10,7 @@ Use KGraph in two steps:
 
 ```bash
 # Required once per repository
-kgraph init --integrations codex,copilot,cursor,claude-code
+kgraph init --integrations codex,copilot,cursor,claude-code,gemini,windsurf,cline
 
 # Normal daily command
 kgraph "auth token refresh"
@@ -89,7 +89,7 @@ From the root of a repository:
 kgraph init
 
 # 2. Optional: connect AI tools so they know the KGraph workflow
-kgraph integrate add codex copilot cursor claude-code
+kgraph integrate add codex copilot cursor claude-code gemini windsurf cline
 
 # 3. Run the normal workflow for a topic
 kgraph "auth token refresh"
@@ -120,7 +120,7 @@ kgraph init
 Required once per repo. Creates `.kgraph/` and the local config.
 
 ```bash
-kgraph init --integrations codex,copilot,cursor,claude-code
+kgraph init --integrations codex,copilot,cursor,claude-code,gemini,windsurf,cline
 ```
 
 Initializes KGraph and writes local instruction files for supported AI tools.
@@ -196,7 +196,7 @@ Show processed cognition sessions.
 KGraph integrations are local files. They do not start background agents, call AI providers, or send data anywhere.
 
 ```bash
-kgraph integrate add codex copilot cursor claude-code
+kgraph integrate add codex copilot cursor claude-code gemini windsurf cline
 kgraph integrate list
 kgraph integrate remove cursor
 ```
@@ -207,6 +207,11 @@ kgraph integrate remove cursor
 | GitHub Copilot | `.github/copilot-instructions.md`, `.github/prompts/*` |
 | Cursor | `.cursor/rules/kgraph.mdc` |
 | Claude Code | `CLAUDE.md`, `.claude/commands/*` |
+| Gemini CLI | `GEMINI.md` |
+| Windsurf | `.windsurf/rules/kgraph.md` |
+| Cline | `.clinerules/kgraph.md` |
+
+Antigravity is supported through the existing agent instruction surfaces it can read, especially `AGENTS.md` and `GEMINI.md`; it does not need a separate KGraph adapter yet.
 
 KGraph preserves existing user-authored content and updates only its marked instruction blocks or generated command files.
 

package/dist/cli/help.js

@@ -2,7 +2,7 @@ import { Chalk } from 'chalk';
 import figlet from 'figlet';
 export function renderRootHelp(useColor = supportsColor()) {
     const theme = new Chalk({ level: useColor ? 3 : 0 });
-    const command = (name, description) => `  ${theme.green(name.padEnd(30))} ${description}`;
+    const command = (name, description) => `  ${theme.green(name.padEnd(42))} ${description}`;
     const logo = renderLogo();
     return [
         '',
@@ -11,7 +11,7 @@ export function renderRootHelp(useColor = supportsColor()) {
         `  ${theme.bold('KGraph')} ${theme.dim('Persistent repo intelligence for AI coding tools')}`,
         '',
         `  ${theme.hex('#c084fc')('Build a local knowledge layer that helps Codex, Copilot, Cursor,')}`,
-        `  ${theme.hex('#c084fc')('and Claude Code reuse repo structure, decisions, and debugging history.')}`,
+        `  ${theme.hex('#c084fc')('Claude Code, Gemini, Windsurf, and Cline reuse repo intelligence.')}`,
         '',
         theme.bold('Usage'),
         '  kgraph [topic]',
@@ -19,7 +19,7 @@ export function renderRootHelp(useColor = supportsColor()) {
         '',
         theme.bold('Start'),
         command('init', 'Required once: create .kgraph/ workspace'),
-        command('init --integrations codex,cursor', 'Initialize and connect AI tools'),
+        command('init --integrations codex,gemini', 'Initialize and connect AI tools'),
         '',
         theme.bold('Daily workflow'),
         command('kgraph', 'Refresh scan maps and process pending cognition notes'),
@@ -38,7 +38,7 @@ export function renderRootHelp(useColor = supportsColor()) {
         '',
         theme.bold('Integrations'),
         command('integrate list', 'Show configured AI tool integrations'),
-        command('integrate add codex copilot', 'Write KGraph instructions for AI tools'),
+        command('integrate add gemini windsurf cline', 'Write KGraph instructions for AI tools'),
         command('integrate remove cursor', 'Remove KGraph-managed instruction blocks'),
         '',
         theme.bold('Options'),
@@ -46,7 +46,7 @@ export function renderRootHelp(useColor = supportsColor()) {
         command('-h, --help', 'Show this help'),
         '',
         `${theme.yellow('Examples')}`,
-        '  kgraph init --integrations codex,copilot,cursor',
+        '  kgraph init --integrations codex,copilot,cursor,claude-code,gemini,windsurf,cline',
         '  kgraph "blog admin token usage"',
         '  kgraph doctor',
         '',
@@ -56,7 +56,7 @@ export function renderRootHelp(useColor = supportsColor()) {
 }
 export function renderWorkflowBanner(stats, useColor = supportsColor()) {
     const theme = new Chalk({ level: useColor ? 3 : 0 });
-    const command = (name, description) => `  ${theme.green(name.padEnd(30))} ${description}`;
+    const command = (name, description) => `  ${theme.green(name.padEnd(42))} ${description}`;
     return [
         '',
         theme.hex('#7dd3fc').bold(renderLogo()),

package/dist/config/config.js

@@ -25,10 +25,13 @@ export const DEFAULT_CONFIG = {
         'specs',
         '.cursor',
         '.claude',
+        '.windsurf',
+        '.clinerules',
         '.github/copilot-instructions.md',
         '.github/prompts',
         'AGENTS.md',
         'CLAUDE.md',
+        'GEMINI.md',
         'REQUIREMENTS.md',
         '*.log',
         '*.tgz',
@@ -132,7 +135,15 @@ function normalizeIntegrations(value) {
             seen.has(candidate.name)) {
             continue;
         }
-        if (!['claude-code', 'codex', 'copilot', 'cursor'].includes(candidate.name)) {
+        if (![
+            'claude-code',
+            'cline',
+            'codex',
+            'copilot',
+            'cursor',
+            'gemini',
+            'windsurf',
+        ].includes(candidate.name)) {
             continue;
         }
         seen.add(candidate.name);

package/dist/integrations/adapters/cline.d.ts

@@ -0,0 +1,2 @@
+import type { IntegrationAdapter } from '../integration-registry.js';
+export declare const clineAdapter: IntegrationAdapter;

package/dist/integrations/adapters/cline.js

@@ -0,0 +1,17 @@
+export const clineAdapter = {
+    name: 'cline',
+    label: 'Cline',
+    targetPath: '.clinerules/kgraph.md',
+    instructions: `# KGraph Workflow
+
+- **Before exploring the repository**, run \`kgraph "<topic>"\` to refresh maps, process pending inbox notes, and load focused repo intelligence. Use the returned files, symbols, relationships, and cognition before any broad exploration.
+- Run \`kgraph doctor\` when setup, maps, inbox processing, or integrations look wrong. Run \`kgraph doctor --quality\` when context shows stale/noisy cognition references.
+- At the end of any session that changed repository files, check the KGraph capture workflow before finishing.
+- If the file change has future value, write one concise Markdown note to \`.kgraph/inbox/<slug>.md\`; otherwise explicitly skip capture as trivial.
+- Skip capture only for read-only work, trivial formatting, typo-only docs, dependency-only churn, mechanical cleanup with no future value, or sessions where no repo files changed.
+- Do not run KGraph repeatedly. Run it once at the start with \`kgraph "<topic>"\`. If repo files changed, write any needed inbox note first, then run \`kgraph\` once at the end.
+- Run \`kgraph repair --dry-run\` before cleanup when stale/noisy cognition needs fixing. Run \`kgraph repair\` only when the user asks to apply that cleanup.
+- Run \`kgraph visualize\` to open the interactive dependency graph at http://localhost:4242 with PNG export.
+- Run \`kgraph history\` to review the timeline of past cognition sessions with git author attribution.
+`,
+};

package/dist/integrations/adapters/gemini.d.ts

@@ -0,0 +1,2 @@
+import type { IntegrationAdapter } from '../integration-registry.js';
+export declare const geminiAdapter: IntegrationAdapter;

package/dist/integrations/adapters/gemini.js

@@ -0,0 +1,17 @@
+export const geminiAdapter = {
+    name: 'gemini',
+    label: 'Gemini CLI',
+    targetPath: 'GEMINI.md',
+    instructions: `## KGraph Workflow
+
+- **Before exploring the repository**, run \`kgraph "<topic>"\` to refresh maps, process pending inbox notes, and load focused repo intelligence. Use the returned files, symbols, relationships, and cognition before any broad exploration.
+- Run \`kgraph doctor\` when setup, maps, inbox processing, or integrations look wrong. Run \`kgraph doctor --quality\` when context shows stale/noisy cognition references.
+- At the end of any session that changed repository files, check the KGraph capture workflow before finishing.
+- If the file change has future value, write one concise Markdown note to \`.kgraph/inbox/<slug>.md\`; otherwise explicitly skip capture as trivial.
+- Skip capture only for read-only work, trivial formatting, typo-only docs, dependency-only churn, mechanical cleanup with no future value, or sessions where no repo files changed.
+- Do not run KGraph repeatedly. Run it once at the start with \`kgraph "<topic>"\`. If repo files changed, write any needed inbox note first, then run \`kgraph\` once at the end.
+- Run \`kgraph repair --dry-run\` before cleanup when stale/noisy cognition needs fixing. Run \`kgraph repair\` only when the user asks to apply that cleanup.
+- Run \`kgraph visualize\` to open the interactive dependency graph at http://localhost:4242 with PNG export.
+- Run \`kgraph history\` to review the timeline of past cognition sessions with git author attribution.
+`,
+};

package/dist/integrations/adapters/windsurf.d.ts

@@ -0,0 +1,2 @@
+import type { IntegrationAdapter } from '../integration-registry.js';
+export declare const windsurfAdapter: IntegrationAdapter;

package/dist/integrations/adapters/windsurf.js

@@ -0,0 +1,17 @@
+export const windsurfAdapter = {
+    name: 'windsurf',
+    label: 'Windsurf',
+    targetPath: '.windsurf/rules/kgraph.md',
+    instructions: `# KGraph Workflow
+
+- **Before exploring the repository**, run \`kgraph "<topic>"\` to refresh maps, process pending inbox notes, and load focused repo intelligence. Use the returned files, symbols, relationships, and cognition before any broad exploration.
+- Run \`kgraph doctor\` when setup, maps, inbox processing, or integrations look wrong. Run \`kgraph doctor --quality\` when context shows stale/noisy cognition references.
+- At the end of any session that changed repository files, check the KGraph capture workflow before finishing.
+- If the file change has future value, write one concise Markdown note to \`.kgraph/inbox/<slug>.md\`; otherwise explicitly skip capture as trivial.
+- Skip capture only for read-only work, trivial formatting, typo-only docs, dependency-only churn, mechanical cleanup with no future value, or sessions where no repo files changed.
+- Do not run KGraph repeatedly. Run it once at the start with \`kgraph "<topic>"\`. If repo files changed, write any needed inbox note first, then run \`kgraph\` once at the end.
+- Run \`kgraph repair --dry-run\` before cleanup when stale/noisy cognition needs fixing. Run \`kgraph repair\` only when the user asks to apply that cleanup.
+- Run \`kgraph visualize\` to open the interactive dependency graph at http://localhost:4242 with PNG export.
+- Run \`kgraph history\` to review the timeline of past cognition sessions with git author attribution.
+`,
+};

package/dist/integrations/integration-registry.js

@@ -1,12 +1,18 @@
 import { claudeCodeAdapter } from "./adapters/claude-code.js";
+import { clineAdapter } from "./adapters/cline.js";
 import { codexAdapter } from "./adapters/codex.js";
 import { copilotAdapter } from "./adapters/copilot.js";
 import { cursorAdapter } from "./adapters/cursor.js";
+import { geminiAdapter } from "./adapters/gemini.js";
+import { windsurfAdapter } from "./adapters/windsurf.js";
 const ADAPTERS = [
     claudeCodeAdapter,
+    clineAdapter,
     codexAdapter,
     copilotAdapter,
-    cursorAdapter
+    cursorAdapter,
+    geminiAdapter,
+    windsurfAdapter
 ].sort((left, right) => left.name.localeCompare(right.name));
 export function listIntegrationAdapters() {
     return ADAPTERS;

package/dist/types/config.d.ts

@@ -12,7 +12,7 @@ export interface DomainHint {
     paths?: string[];
     tags?: string[];
 }
-export type IntegrationName = "claude-code" | "codex" | "copilot" | "cursor";
+export type IntegrationName = "claude-code" | "cline" | "codex" | "copilot" | "cursor" | "gemini" | "windsurf";
 export interface IntegrationConfig {
     name: IntegrationName;
     enabled: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kentwynn/kgraph",
-  "version": "0.1.19",
+  "version": "0.1.20",
   "description": "Persistent repo intelligence for AI coding assistants.",
   "type": "module",
   "bin": {