files:iterate
Iterate over repository files matching a glob.
Syntax#
vigil files:iterate [--root path] [--glob pattern] [--json|--jsonl|--format text|json|jsonl]
Options#
| Flag | Description |
|---|
--json | Emit the versioned JSON envelope. |
--format | Select a machine or human output format. |
--root | Choose the iteration root. |
--glob | Filter files with a glob. |
--jsonl | Emit versioned JSONL events. |
Examples#
vigil files:iterate [--root path] [--glob pattern] [--json|--jsonl|--format text|json|jsonl]
vigil files:iterate --json
Example Use Cases#
- Use this command when you need to iterate over repository files matching a glob.
- Run it in local checks, scripts, or CI when read-only evidence is needed.
Technical Contract#
| Binding | builtin:files:iterate |
|---|
| Stability | experimental |
|---|
| Timeout | 10m0s |
|---|
| Required tools | None |
|---|
| Capabilities | filesystem:read |
|---|
| Output formats | text, json, jsonl |
|---|