# sgit ls, cli.sgit.ai

> List vault files with fetch status

*Source: <https://cli.sgit.ai/reference/ls.html> · generated from the same content as the page, so the two cannot drift.*

---
# sgit ls

List vault files with fetch status.

*Generated from `sgit help all --format json`, sgit-ai v0.23.0. No subcommands. To change this page, change the command's `register()` in the CLI and regenerate.*

```text
sgit ls [options] [path] [directory]
```

| Argument | | What it is |
|---|---|---|
| `path` | optional | Subdirectory or file path (default: root) |
| `directory` | optional | Vault directory (default: .) |

| Option | What it does |
|---|---|
| `--ids` | Include blob IDs in output |
| `--json` | Output full entry metadata as JSON array |

---

*[Site index for agents](../llms.txt) · [HTML version](https://cli.sgit.ai/reference/ls.html)*