OpenWiki icon

OpenWiki

OpenWiki 是一款用于生成和维护代码库文档的命令行工具,专注于为代理提供上下文;可初始化仓库文档、持续更新,并通过 AGENTS.md 和 CLAUDE.md 提供指引。

OpenWiki

概述

OpenWiki 是一款用于生成和维护代码库文档的 CLI,尤其侧重于帮助代理与该仓库协作的文档。README 将其描述为一种用于创建初始文档、在代码库变化时保持文档最新,并添加指导文件以告诉编码代理去哪里查找上下文的工具。

在实际使用中,OpenWiki 旨在融入开发者工作流:通过 npm 安装,在仓库中初始化,然后可以交互式运行,或者生成一次性摘要。该项目还包含一个 GitHub Actions 工作流,可以按计划打开包含文档更新的拉取请求,这使得仓库文档更容易随着时间保持同步。

OpenWiki 的功能

命令行工作流

作为 CLI 运行,而不是网页应用,因此文档生成和更新都在终端中完成。

生成并维护文档

当还没有 wiki 时,会在 openwiki/ 目录中创建初始文档,然后随着仓库变化刷新这些内容。

交互式与打印模式

可以在运行后保持打开以便继续提问,也可以使用 -p / --print 立即退出,实现一次性输出。

面向代理的提示

更新 AGENTS.md 和 CLAUDE.md 等仓库指引文件,让代理转向生成的文档。

多个模型提供方

开箱即支持多个推理提供方,包括 OpenRouter、Fireworks、Baseten、OpenAI 和 Anthropic。

本地设置与追踪支持

可选将配置和 LangSmith API 密钥本地保存到 ~/.openwiki/.env,以便对运行进行追踪。

常见用例

  • 为仓库搭建文档基础

    当新的代码库需要为代理和贡献者提供结构化起点时,生成仓库文档的初稿。

  • 在代码库演进时维护文档

    通过重新运行 OpenWiki,或使用会按计划打开更新 PR 的仓库工作流,让面向代理的文档与代码变更保持一致。

  • 改善代理上下文发现

    通过将仓库指引文件链接到生成的 OpenWiki 内容,为编码代理提供更清晰的上下文查找入口。

  • 一次性文档运行

    无需停留在交互会话中,也能从终端快速生成摘要或文档快照。

  • 在多个仓库中重复同一文档流程

    在依赖相同 CLI 设置和模型提供方配置的项目之间,标准化文档工作流。

Pros and Cons

Pros

  • 专门面向代理文档,而不只是通用项目笔记。
  • 可以初始化新文档,并根据仓库变更刷新现有文档。
  • 支持交互式使用和非交互式一次性输出。
  • 开箱即支持多个主流推理提供方。
  • 可以将文档指引集成到 AGENTS.md 和 CLAUDE.md 文件中。

Cons

  • 源材料没有提供完整的功能矩阵,因此仅凭 README,某些能力和限制仍不够明确。
  • 文档更新工作流依赖 GitHub Actions 和仓库设置,因此自动刷新取决于该环境。

FAQ

如何使用 OpenWiki?

OpenWiki 通过 npm 安装,并从命令行启动。README 展示了全局安装命令,然后可以使用交互式启动或一次性打印模式来生成文档。

OpenWiki 会创建还是更新文档?

是的。README 说明,OpenWiki 可以在不存在 wiki 时在 openwiki/ 目录中创建初始文档,并在该目录已存在时根据仓库变更刷新这些文档。

OpenWiki 支持哪些模型提供方?

OpenWiki 开箱即支持 OpenRouter、Fireworks、Baseten、OpenAI 和 Anthropic,并且允许你为每个推理提供方指定自定义模型 ID。

OpenWiki 如何帮助其他代理找到文档?

README 说明,OpenWiki 可以向 AGENTS.md 和/或 CLAUDE.md 追加提示内容,从而让编码代理知道在查找上下文时要参考 OpenWiki 文档。

OpenWiki 是免费的吗?

该仓库本身在 GitHub 上是开源的,并采用 MIT 许可证。GitHub 的定价页面显示,GitHub 提供包含公共和私有仓库的免费方案,但该定价页面并不能说明 OpenWiki 本身有单独的付费价格。

Quick Facts

类别
开发者工具
产品类型
CLI
主要用途
代码库的代理文档
安装
npm install -g openwiki
许可证
MIT
仓库托管平台
GitHub