Ask AI
Ask AI Start conversation ↵

I'm an AI assistant with Grove's codebase and documentation in context.

Ask me anything about Grove.

EXAMPLE QUESTIONS

Open what the agent produced

An artifact is a file or a link an agent attaches to its workspace, so the plan, the report or the diagram is one click from the dashboard instead of a path in a chat message.

A Grove workspace page with the Info tab open. Under the Tickets card an Artifacts card lists a Markdown plan, a draw.io diagram, a Python report and an external link, each with its own icon.
The Artifacts card under Tickets. A file shows its type icon and a link shows its site's favicon.

Think of an artifact as a bookmark the agent leaves on its workbench. Grove keeps the pointer, and the agent keeps the content.

  • The agent runs grove artifacts attach docs/plan.md, or calls grove_attach_artifact, and the file appears on the workspace.
  • A target that starts with http:// or https:// is a link. Anything else is a path to an existing file.
  • An optional title replaces the file name on the card.
  • Attaching the same target again changes nothing, and attaching it with a new title renames the row.
  • You can attach and detach from the Controls tab too. One field takes a path or a link.

Read it in the dashboard

The Info tab lists every artifact directly under Tickets.

  • A link opens in a new tab.
  • A file opens in a read-only viewer. PDF, Word, Excel and CSV, PowerPoint, archives, email, ebooks, Markdown, code, images, audio and video render in the browser, with no conversion server.
  • A .diff or .patch opens as a side-by-side diff with added lines in green and removed lines in red. A .jsonl opens as JSON. A Jinja template (.j2, .jinja, .jinja2) opens as the file it produces, so plan.md.j2 renders as Markdown, and as plain text when only the suffix names it.
  • DWG and DWF drawings, Typst sources and Adobe design files are not previewed. Their runtimes are large, and the CAD one is AGPL.
  • A .drawio file opens in the same read-only diagram viewer the Gallery uses, with page tabs. A workspace can carry as many diagrams as it needs.
  • The viewer reads the file each time it opens, and Refresh reads it again. An agent that keeps editing its plan never has to attach it twice.
  • Artifacts are private to the dashboard. A public share link shows none of them.

Which files can be attached

Grove serves a file only if it was attached, and attaches it only from a directory you allowed.

  • The workspace checkout and the project root are always allowed.
  • /tmp is allowed by default, for reports an agent writes outside the repository.
  • A file anywhere else is refused, and so is a symlink that points outside those directories.
  • The check runs again on every read. A file that later moves out of bounds stops opening.
  • A file over 32 MB is refused.

Configuration

artifacts.roots lists the extra directories. Set it in your user config or the project's .grove/config.local.json. A committed project config cannot set it, so a cloned repository cannot widen what the dashboard reads.

~/.config/grove/config.json
{
  "artifacts": {
    "roots": ["/tmp", "~/notes"]
  }
}

See also