> ## Documentation Index
> Fetch the complete documentation index at: https://devgraph.ameyalambat.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Persistent local code memory for AI coding assistants.

# What is DevGraph?

DevGraph is a file-first local memory system for code understanding. It incrementally indexes your repo into a graph inside `.devgraph/` so coding assistants can query structure instead of rereading the entire codebase.

## Key Features

<CardGroup cols={2}>
  <Card title="Incremental Build" icon="folder-tree">
    Sync changed files only. DevGraph hashes source files and reuses cached per-file artifacts.
  </Card>

  <Card title="On-device Memory" icon="hard-drive">
    Everything lives in `.devgraph/` as plain files you can inspect, diff, and keep local.
  </Card>

  <Card title="Code-first Graph" icon="code">
    V1 indexes files, symbols, imports, references, and lightweight context files like `README.md`.
  </Card>

  <Card title="Focused Retrieval" icon="magnifying-glass">
    Use `devgraph query` for bounded evidence instead of broad file search.
  </Card>

  <Card title="Self-updating Loop" icon="arrows-rotate">
    Run `devgraph watch` to keep the graph fresh while you edit code.
  </Card>
</CardGroup>

## Generated Outputs

When you run `devgraph build`, DevGraph writes:

| File            | Description                                                            |
| --------------- | ---------------------------------------------------------------------- |
| `manifest.json` | Tracks indexed paths, hashes, kinds, extraction version, and sync time |
| `graph.json`    | Canonical local memory graph for query and agent use                   |
| `cache/*.json`  | Per-file extracted artifacts used for incremental rebuilds             |

## Command Surface

DevGraph v1 ships four commands:

* `devgraph build [paths...]`
* `devgraph watch [paths...]`
* `devgraph query "<question>"`
* `devgraph status`

## Next Steps

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/docs/quickstart">
    Build your first local memory graph and inspect the outputs.
  </Card>

  <Card title="CLI Commands" icon="terminal" href="/docs/cli/build">
    Learn the build, watch, query, and status workflows.
  </Card>

  <Card title="Query Command" icon="magnifying-glass" href="/docs/cli/query">
    Use graph retrieval instead of broad repo search.
  </Card>
</CardGroup>