Repo Wiki

Repo Wiki automatically generates structured documentation for your project and continuously tracks changes in code and documentation.

When you query knowledge points, code explanations, or add feature enhancements during development, Repo Wiki deeply analyzes the project structure and code implementation. Combining Repo Wiki with context information, it provides more accurate and detailed answers and documentation support, giving the agent a deeper understanding of the codebase.

Use Cases

• Architecture and Implementation Queries
  Relying on pre-built architectural knowledge, the agent can quickly answer questions like “How is X implemented?” or “Which services depend on this module?” with almost no need to invoke tools.
• Agent-Driven Development Tasks
  When context width is limited, Repo Wiki accelerates code location, supporting tasks such as:
  • Adding new features
  • Fixing bugs

Repo Wiki Generation

The Wiki in your repository is not static—it stays synchronized with your code.

The Wiki updates in three key scenarios. Understanding when and why it triggers helps you keep the Wiki updated in real-time.

1. Initial Wiki Generation When you open a project for the first time, no Wiki exists by default. You can generate it from scratch with one click.
2. Code Changes Detected After the initial generation, the system continuously monitors code changes. If you modify content already recorded by the Wiki (e.g., function signatures, class definitions, API endpoints), the system detects the inconsistency between the current code and the existing Wiki. You can click Update to regenerate only the affected parts.
3. Git Directory Sync If you directly edit Markdown files in the Git directory, the system detects inconsistencies between the Git content and the Wiki. You can click Sync to synchronize the Git changes and update the Wiki.
4. Generation Limits
   • A maximum of 10,000 files per project. If your project contains more than 10,000 files, it is recommended to exclude non-essential paths in Qoder Settings → Codebase Indexing → Index Exclusions.
   • Only supports Git repositories with at least one commit.

Intervening in Wiki Generation

Repo Wiki is not a “generate once and read-only” artifact. You can guide the direction through a configuration file before generation, or modify it anytime after generation. Every knowledge revision made by the team is recognized by the system as new cognitive deposits—it won’t be overwritten by the next automatic update, but instead reverse-synced to the corresponding knowledge cards—truly embedding human judgment into knowledge assets.

/knowledge Command

Type /knowledge in the chat input to intervene in Repo Wiki and Knowledge Cards:

Operation	Description
Generate	Generate Wiki or Knowledge Cards for the project for the first time
Modify	Make partial modifications to existing knowledge content
Supplement	Append new content to existing knowledge
Rewrite	Completely rewrite a knowledge page or card

How to use:

1. Invoke /knowledge in the input box
2. Enter your instruction describing the desired changes
3. Optionally upload local files as reference (e.g., design docs, API docs)
4. The Agent will modify the corresponding knowledge content based on your instruction

Manually modified content is marked and protected by the system—it won’t be overwritten during the next automatic update, making every team knowledge revision a persistent knowledge asset.

wiki_plan.yaml — Pre-Generation Configuration

Through a configuration file, you can inject guiding intent before Wiki generation to control direction and scope.

Type /knowledge-plan in the chat input to create or edit the wiki_plan.yaml pre-generation configuration file, controlling the generation strategy for Wiki and Knowledge Cards.

File location:

<project_root>/.qoder/repowiki/wiki_plan.yaml

This file is shared with the team via Git commits.

Configuration structure:

version: 1

repowiki:
  template: ""           # Preset template (architecture / product_requirement)
  notes:                 # Inject guidance prompts during the planning phase
    - text: "Prompt text"
      author: "Author"
  documents:             # Page allowlist (strictly outputs listed pages when provided)
    - title: "Page title"
      goal: "Writing intent for this page"
      parent: ""         # Optional, parent page title
      hints: ""          # Optional, additional writing hints

knowledgecard:
  notes:                 # Inject guidance prompts for knowledge card planning
    - text: "Prompt text"

scope:
  include: []            # File allowlist (.gitignore syntax)
  exclude: []            # File blocklist (.gitignore syntax)

Key configuration options:

Option	Description
repowiki.template	Preset template: architecture (comprehensive technical analysis) or product_requirement (product requirements format output)
repowiki.notes	Guidance prompts injected during planning to direct AI focus
repowiki.documents	Page allowlist; when provided, pages are strictly generated per the list
knowledgecard.notes	Knowledge card guidance prompts, influencing module partitioning
scope.include / exclude	Controls which files are visible during generation

Example:

version: 1

repowiki:
  notes:
    - text: "Documentation should focus on business workflows rather than code details, targeting new engineers"
  documents:
    - title: "System Architecture Overview"
      goal: "Describe overall system architecture, core modules and their interactions"
    - title: "Order System"
      goal: "Explain the full order lifecycle"
      parent: "System Architecture Overview"

knowledgecard:
  notes:
    - text: "Focus on modeling the payment and order core subsystems"

scope:
  include:
    - "src/**"
  exclude:
    - "**/test/**"

After modifying wiki_plan.yaml, you need to manually trigger “Generate” or “Regenerate” for changes to take effect.

Repo Wiki Sharing

Supports Wiki sharing to facilitate more efficient knowledge flow within the team.

Once a team administrator enables the Knowledge Engine toggle in the Web console, any Repo Wiki generated by a team member is automatically synced to the team. Other members simply open the same repository branch and click Generate to automatically retrieve the team’s latest knowledge—no manual pulling required. Any changes to the project’s knowledge by team members are synced to everyone, ensuring the team’s knowledge stays consistent and up-to-date.

Automatic team sharing is only available in the Teams plan. Alternatively, you can manage knowledge via Git sync.

When generating a Wiki locally, the system automatically creates a dedicated directory in your code repository: .qoder/repowiki.

You can commit and push this directory to a remote branch. Team members can then pull the generated Wiki content via git pull—no extra configuration required.

Multilingual Support

The Wiki system supports multiple languages—you can select your preferred language when generating the Wiki. Currently, English and Chinese are supported.

When generating the Wiki, the system automatically creates independent directories for each selected language under the Git directory based on your language choices (e.g., repowiki/zh/, repowiki/en/).

Billing

Generating and updating the Repo Wiki consumes Credits as usual. You can check the consumption records in Usage - Credits.