opencode-python-docs

python-docs

OpenCode plugin for Python documentation lookup via DevDocs.

Quick Start

Add to ~/.config/opencode/opencode.json:

{ "plugin": ["python-docs"] }

Or use a local path during development:

{ "plugin": ["~/Dump/python-docs"] }

Features

• Search Python stdlib, language reference, tutorials, and more
• Fetch full documentation as clean Markdown
• Cache with intelligent TTL-based garbage collection
• Multiple versions supported: 3.14, 3.13, 3.12, 3.11, 3.10, 3.9

Tools

python_docs

Search Python documentation index.

Argument	Type	Description
query	string	Search query (e.g., 'asyncio', 'pathlib')
version	string?	Python version (default: 3.14)
type	string?	Filter by doc type
limit	number?	Max results (default: 20)

Example:

python_docs query="asyncio" version="3.12"

fetch_python_doc

Fetch full documentation as Markdown.

Argument	Type	Description
path	string	Doc path from search results
version	string?	Python version (default: 3.14)

Example:

fetch_python_doc path="library/asyncio"

Caching

• Index cache: 24 hours TTL
• Doc cache: 7 days TTL
• Location: ~/.cache/opencode/plugins/python-docs/
• Garbage collection: Runs on startup and reconnect

Development

git clone <repo> ~/Dump/python-docs
cd ~/Dump/python-docs
bun install
bun run build

Scripts

Command	Description
bun run build	Build the plugin
bun run typecheck	Run TypeScript type checking
bun run lint	Run Biome linter
bun run format	Format code with Biome

License

MIT