Open Webui AI Context Pack for Claude Code, Codex, Cursor, and Aider

Pack version: v1.1.0 · Last updated: 2026-05-15

Languages: English | 中文

Self-hosting open-webui means dealing with Docker permission errors, auth configuration traps, and OAI endpoint failures that the official quickstart does not walk you through.

This is an independent AI context resource pack for open-webui/open-webui: host instructions, prompt preview, evals, pitfalls, and recovery rules you can load into Claude Code, Codex, Cursor, Aider, and other AI coding agents.

This is an independent capability pack. It is not affiliated with or endorsed by open-webui/open-webui unless explicitly stated.

Copy / Run / Verify

1. Copy AGENTS.md into your AI coding host (or CLAUDE.md for Claude Code).
2. Run the first prompt in 01_PROMPT_PREVIEW.md.
3. Verify behavior with 06_EVALS/smoke_check.md, then recover with 03_PITFALL_LOG.md if it fails.

Quick links: Start · Prompt · Evals · Pitfalls · Manual

When This Helps

Use this pack when you want an AI coding agent to understand the upstream project context, setup boundaries, common pitfalls, and verification steps before it edits files, installs dependencies, or claims the tool is ready.

What You Get

• Host instructions for AI coding agents.
• A copyable prompt preview.
• Acceptance checks.
• Pitfall log and recovery steps for self-hosted open-webui failures.
• Boundary and risk card.
• Human reference manual (05_HUMAN_MANUAL.md) — architecture, components, and failure taxonomy.
• Human reference manual (05_HUMAN_MANUAL.md) — architecture, components, and failure taxonomy.
• Source attribution and upstream links.

If this pack helps your agent work from evidence instead of guesses, star the repo so future updates are easier to find. Open an issue for bugs, usage questions, or new pitfall reports.

AGENTS.md for Claude Code and AI Coding Agents

Use AGENTS.md for agent hosts that support repository instructions. Use CLAUDE.md when Claude Code is the target host.

open-webui/open-webui Pitfalls and Recovery

Start with 03_PITFALL_LOG.md when setup, permissions, runtime behavior, or verification fails.

Source Attribution

This project pack was assembled by Doramagic to make open-webui/open-webui usable as a portable AI capability asset.

• Upstream/source: https://github.com/open-webui/open-webui
• License: NOASSERTION
• Pack contents: prompts, host instructions, checks, guardrails, and validation notes
• Relationship: independent pack; not affiliated with or endorsed by open-webui/open-webui unless explicitly stated

If you maintain the upstream project and want attribution changed or removed, open an issue in this repository.