Wiki

Read and write to a directory of markdown files. The provider exposes two tools: query_wiki for reading, update_wiki for writing. With a Git backend, writes auto-commit and push. With a Notion backend, writes sync to a Notion database.

from os import getenv
from agno.agent import Agent
from agno.context.wiki import WikiContextProvider
from agno.context.wiki.backend import GitBackend

wiki = WikiContextProvider(
    backend=GitBackend(
        repo_url="https://github.com/org/wiki.git",
        branch="main",
        github_token=getenv("GITHUB_TOKEN"),
    )
)

await wiki.asetup()

agent = Agent(
    model=...,
    tools=wiki.get_tools(),
)

await agent.arun("Add a page about our deployment process")
await wiki.aclose()

Backends

Git
Filesystem
Notion

Auto-commits and pushes changes.

from os import getenv
from agno.context.wiki.backend import GitBackend

backend = GitBackend(
    repo_url="https://github.com/org/wiki.git",
    branch="main",
    github_token=getenv("GITHUB_TOKEN"),
)
wiki = WikiContextProvider(backend=backend)

Local directory, no Git.

from agno.context.wiki.backend import FileSystemBackend

backend = FileSystemBackend(path="./wiki")
wiki = WikiContextProvider(backend=backend)

Mirrors a Notion database. Each row becomes a local markdown page; writes push back to Notion, which stays the source of truth.

uv pip install -U notion-client

from os import getenv
from agno.context.wiki.backend import NotionDatabaseBackend

backend = NotionDatabaseBackend(
    database_id=getenv("NOTION_DATABASE_ID"),
    token=getenv("NOTION_API_KEY"),
)
wiki = WikiContextProvider(backend=backend)

token falls back to the NOTION_API_KEY environment variable. NotionPageBackend (nested page trees) is planned and raises NotImplementedError today. See the Notion wiki example.

Configuration

Parameter	Type	Default	Description
`backend`	`WikiBackend`	required	GitBackend, FileSystemBackend, or NotionDatabaseBackend.
`id`	`str`	`"wiki"`	Tools become `query_<id>` and `update_<id>`.
`web`	`ContextBackend`	`None`	Optional web backend for ingestion (fetch URL → write page).
`model`	`Model`	`None`	Model for sub-agents.
`read`	`bool`	`True`	Expose `query_wiki`.
`write`	`bool`	`True`	Expose `update_wiki`.

Tools Exposed

Tool	Description
`query_wiki`	Search pages, read content, list structure.
`update_wiki`	Create pages, edit content. Auto-commits with Git backend.

Web Ingestion

Add a web backend to let the agent fetch URLs and write them as wiki pages:

from agno.context.web import ExaBackend

wiki = WikiContextProvider(
    backend=GitBackend(...),
    web=ExaBackend(),
)

# Agent can now: "Add this article to the wiki: https://..."

ExaBackend requires the exa-py package (uv pip install -U exa-py) and the EXA_API_KEY environment variable. See Web for other backends.

Lifecycle Management

With GitBackend, asetup() clones the repo. Queries and updates run it automatically on first use; call it at startup to surface clone errors early:

await wiki.asetup()   # Clone repo
try:
    agent = Agent(model=..., tools=wiki.get_tools())
    await agent.arun("What do we have documented about deployments?")
finally:
    await wiki.aclose()

Example queries

Query	What happens
”What do we have documented about authentication?”	Searches wiki content
”Create a page about the new API endpoints”	Creates markdown file, commits
”Update the deployment guide with the new steps”	Edits file, commits

Backends

Configuration

Tools Exposed

Web Ingestion

Lifecycle Management

Example queries

Resources

Workspace Reference

Cookbook Example

​Backends

​Configuration

​Tools Exposed

​Web Ingestion

​Lifecycle Management

​Example queries

​Resources

Workspace Reference

Cookbook Example

Backends

Configuration

Tools Exposed

Web Ingestion

Lifecycle Management

Example queries

Resources