openwiki logo

openwiki

OpenWiki is a CLI that writes and maintains agent documentation for your codebase.

Developer ToolsAI AgentsTypeScriptMIT 12.4k 852Health 95
Trendshift daily trending badge
GitHub

What is it?

What it is

OpenWiki is a command‑line interface that automatically writes and maintains documentation for a codebase, designed to work with AI agents.

Why it exists

It exists to keep project documentation up‑to‑date without manual effort, enabling agents to reference accurate docs and allowing continuous integration to generate PRs or merge requests with updated documentation.

Who should use it

Developers needing automated documentationTeams maintaining codebases with agentsUsers of LangChain or agent-based workflows

Who should avoid it

Users preferring manual documentationThose without API access to supported providersNon-technical users

How it works

A quick walkthrough in plain English

How openwiki works

Step 1 of 3

You interact with it

Open openwiki, send a request, or connect it to your stack.

Features

CLI interface for documentation generation
Automated codebase documentation maintenance
Agent-specific design for coding agents
CI workflow integration (GitHub/GitLab)
Support for multiple inference providers (OpenAI, Anthropic, etc.)
Customizable base URLs and model IDs
Automatic creation/update of AGENTS.md/CLAUDE.md files

Advantages

  • Saves time with automated documentation
  • Agent-optimized workflow integration
  • Flexible LLM provider support
  • CI automation ensures up-to-date docs
  • Customizable for self-hosted or proxy setups
  • MIT license for open-source use

Disadvantages

  • CLI may require technical expertise
  • Setup involves API key configuration
  • Dependent on third-party LLM providers
  • CI integration requires workflow setup
  • Initial configuration can be time-consuming

Installation

FAQ

How do I install OpenWiki globally?

Run `npm install -g openwiki` to install the CLI globally on your machine.

How do I initialize OpenWiki and configure my LLM provider?

Run `openwiki --init` (or start `openwiki` and follow prompts) to set the inference provider, API key, LLM, and optional LangSmith tracing; settings are saved to `~/.openwiki/.env`.

What are the ways to run OpenWiki (interactive, one-shot, with a prompt)?

Use `openwiki` for interactive mode, `openwiki "<request>"` to start with an initial request, or `openwiki -p "<prompt>"` / `openwiki --print "<prompt>"` for a one-shot non‑interactive run that prints the output.

How can I keep documentation up‑to‑date via CI?

Add the provided workflow files: copy `openwiki-update.yml` to `.github/workflows/` for GitHub Actions, or copy `openwiki-update.gitlab-ci.yml` to `.gitlab-ci.yml` (or include it) for GitLab CI to automatically open PRs/merge requests with doc updates.

How do I customize the inference provider, base URL, or model ID?

Set environment variables like `OPENWIKI_PROVIDER`, `OPENAI_COMPATIBLE_BASE_URL`, `ANTHROPIC_BASE_URL`, etc., or edit `~/.openwiki/.env`; you can also specify a custom model ID via `OPENWIKI_MODEL_ID` for any supported provider.

Where does OpenWiki store configuration and secrets?

Configuration options and API keys are saved locally in `~/.openwiki/.env` on your machine; the CLI also updates `AGENTS.md` and/or `CLAUDE.md` in the repo to point agents to the generated wiki.

Loading documentation…
View on GitHub

Featured in Videos

YouTube tutorials and walkthroughs for openwiki

sd

80,246 views

Starts at 00:00

Share

Alternatives

Similar projects ranked by category, topics, and text overlap.

Compare
openwiki | MushyBook