Implementations
This page lists tools that read or generate workspace.json.
At v0.3, the spec is newly published. Tool authors: if you ship workspace.json support, please open a PR to add your tool here. We list any tool that documents workspace.json reading or writing in its public docs.
Generation Tools
Section titled “Generation Tools”Tools that write agents.workspace.json:
Vreko Daemon-based behavioral observation. Generates workspace.json from real-time codebase monitoring. The reference implementation.
Consumption Tools
Section titled “Consumption Tools”Tools that read agents.workspace.json:
agents-audit Reference CLI for hygiene auditing. Reads workspace.json when present to enhance AGENTS.md audit findings and validate schema compliance.
gsd-plugin v2.42.3 — First shipped consumer. Reads generated.frameworkManifest, generated.fileIndex, manual.fragileFiles, and manual.coChangePatterns from .agents/agents.workspace.json at AI session start.
Generation Approaches
Section titled “Generation Approaches”| Approach | Cadence | Best For | Example |
|---|---|---|---|
| Daemon-based (behavioral) | Continuous | Teams wanting real-time fragility data | Vreko |
| Commit hook | Per commit | Lightweight, CI-friendly | DIY with @workspacejson/spec |
| CI scheduled | Per PR or schedule | CI-first workflows | GitHub Actions + @workspacejson/spec |
| Manual | On demand | Minimal valid file bootstrap | Hand-authored with schema validation |
npm Packages
Section titled “npm Packages”| Package | Description |
|---|---|
agents-audit | The CLI audit tool |
@workspacejson/spec | JSON Schema and TypeScript types for agents.workspace.json |
@workspacejson/rules | The deterministic rule engine |
Add Your Tool
Section titled “Add Your Tool”If your tool reads or writes workspace.json, open a PR to add it here.
Requirements: the tool must document workspace.json reading or writing in its public docs. See the spec for the schema and the JSON Schema for validation.
(More implementations will be listed as they emerge.)