Skip to main content
Workspace context is a text document that Guild passes to every agent when it runs in your workspace. Use it to tell agents about your project, team conventions, preferred tools, and anything else they need to do their job well.

​
What agents see

When an agent runs, it receives a compiled context made up of three parts: The manual context is the part you write and maintain.

​
Edit context

​
Web UI

Open your workspace and click Context in the left sidebar. The editor lets you write in Markdown. Changes are saved as a draft until you publish them.

​
CLI

The guild workspace context edit command opens your $EDITOR with the current published context. When you save and exit, a draft is created automatically.
After editing, publish the draft to make it active:

​
Versions

Every change creates a new version. Versions are either DRAFT or PUBLISHED — only the latest published version is used when agents run.

​
Writing good context

Context is injected verbatim into the agent’s prompt, so write it as if you’re briefing a capable new team member. Include:
  • What the project does and its tech stack
  • Repository structure and important directories
  • Coding conventions and style preferences
  • Tools and services the team uses
  • Links to relevant internal resources
Keep it focused. Long or noisy context degrades agent performance. Aim for what’s genuinely useful for most tasks in this workspace — not an exhaustive wiki. Example: