context.md

agentkit-context

agentkit-context loads prompt/context material into normalized Items.

Built-in sources

AgentsMd

Use AgentsMd for repository or workspace instructions.

Supported modes:

• AgentsMd::discover(path)
  • nearest ancestor AGENTS.md
• AgentsMd::discover_all(path)
  • stacked ancestor AGENTS.md files from root to nearest match

Supported configuration:

• with_file_name(...)
• with_search_dir(...)
• with_path(...)
• with_mode(...)

This makes it possible to combine:

• ancestor discovery
• explicit extra search directories
• explicit file paths

without hardcoding lookup logic in the host application.

Composition

Use ContextLoader to combine multiple context sources:

let items = ContextLoader::new()
    .with_source(AgentsMd::discover_all(workspace_root))
    .load()
    .await?;

The resulting items are ordinary ItemKind::Context transcript entries, so the loop and providers do not need a separate context path.