# `WardrikWorkspace`

File tools for agents, kept in a `WardrikStore`.

A `WardrikCore.Capability` that gives an agent six tools over a tree of files: `read_file`,
`write_file`, `edit_file`, `list_files`, `search_files` and `delete_file`.

    tree = "agents/acme/agent/triage"

    WardrikCore.start_agent(
      agent_id: "acme/triage",
      model: "anthropic:claude-haiku-4-5",
      capabilities: [{WardrikWorkspace, store: store, tree: tree}],
      middleware: [{WardrikWorkspace.Context, store: store, tree: tree, files: ["MEMORY.md"]}]
    )

Use it when an agent should keep notes, or work on files with others.

## Options

  * `:store` - required. The `WardrikStore` the files are kept in.
  * `:tree` - required. The agent's own tree.
  * `:shared` - `WardrikWorkspace.Mount`s for trees shared with the agent. `[]` unless set.

See `WardrikWorkspace.Tools` for each tool's arguments, and `WardrikWorkspace.Context` for
reading files into every turn.

---

*Consult [api-reference.md](api-reference.md) for complete listing*