Skip to content

Document .graph file mode for Cursor, Copilot, Windsurf and other agents #54

@greynewell

Description

@greynewell

Problem

The README and setup wizard mention Claude Code throughout. Users on Cursor, GitHub Copilot, Windsurf, Cline, Aider, or any other agent that can read files have no idea the product works for them.

.graph files work for any agent that can grep or cat files — they're just text files sitting next to source code. This is a massive untapped audience.

Solution

README section: "Works with any AI agent"

Add a section after the quick start that explicitly lists supported agents with one-line setup notes for each:

Agent How it works
Claude Code Auto-reads via grep/cat; install hook for live updates
Cursor .graph.* files appear in context when you open a file
GitHub Copilot Reads files in your workspace; open .graph files to include them
Windsurf Same as Cursor
Aider Pass --read **/*.graph.* to include all graph files
Any agent Run supermodel watch — files stay current automatically

Setup wizard update

Step 3 currently only offers Claude Code hook installation. Should detect other agents (Cursor config in ~/.cursor, etc.) and mention that the product works with them even without a hook — files just won't auto-update on edit.

Separate docs page (optional)

docs/agents.md with per-agent setup instructions and screenshots.

Why this matters

Widening the addressable audience from "Claude Code users" to "anyone using an AI coding agent" is potentially a 10x increase in the install base. It requires no product changes — just documentation.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions