NetFabric/intelligentium / .agents/skills/openwiki
openwiki
UnverifiedInstall, verify, configure, and use the OpenWiki CLI for agent-maintained repository or personal documentation. Use when: checking whether OpenWiki is installed; installing or updating the openwiki npm package; running openwiki --init or --update; generating a codebase wiki; building a personal wiki; configuring model providers, credentials, connectors, CI updates, .openwikiignore, or the visualizer; troubleshooting PATH, Node.js, better-sqlite3, provider, or non-interactive failures. DO NOT USE FOR: editing arbitrary wikis unrelated to OpenWiki; DeepWiki; generic documentation generators; implementing Open Knowledge Format consumers or producers directly (use the okf skill).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.9 KB |
| references/code-mode.md | markdown | 4.8 KB |
| references/configuration-and-troubleshooting.md | markdown | 6.1 KB |
| references/installation.md | markdown | 3.4 KB |
| references/personal-mode.md | markdown | 3.3 KB |
references/installation.md
View on GitHub# OpenWiki Installation
## Prerequisites
The current published package metadata requires Node.js 22 or newer. Verify the live registry requirement before installation because it may change.
```bash
node --version
npm --version
npm view openwiki engines --json
```
| Check | Required outcome |
| --- | --- |
| `node --version` | Satisfies the package's current `engines.node` range |
| `npm --version` | npm is available, normally bundled with Node.js |
| Registry lookup | Resolves the official `openwiki` package |
## Check Whether It Is Installed
Use three independent checks because command discovery, package registration, and runtime health can fail separately.
### macOS And Linux
```bash
command -v openwiki
npm list -g --depth=0 openwiki
openwiki --help
```
### PowerShell
```powershell
Get-Command openwiki -ErrorAction SilentlyContinue
npm list -g --depth=0 openwiki
openwiki --help
```
| Observation | Diagnosis |
| --- | --- |
| Command path, npm entry, and help output | Healthy global installation |
| npm entry only | Global package exists but its executable directory is not on `PATH` |
| Command path only | Executable may come from another package manager or stale install |
| Help emits Node engine or module error | Runtime or dependency mismatch |
| All checks fail | Install OpenWiki |
OpenWiki has no documented `--version` flag. Read the installed version with:
```bash
npm list -g --depth=0 openwiki
```
Compare it with the registry without installing:
```bash
npm view openwiki version
```
## Install Globally
Use npm, the official quickstart path:
```bash
npm install -g openwiki
openwiki --help
```
Or use pnpm:
```bash
pnpm setup # Run once if the global bin directory is not configured
pnpm add -g openwiki
openwiki --help
```
On Windows, prefer npm or pnpm. Bun may compile the native `better-sqlite3` dependency and require Visual Studio Build Tools with the Desktop development with C++ workload.
## Repair PATH
If npm lists OpenWiki but the shell cannot find it:
```bash
npm prefix -g
```
On macOS and Linux, global executables normally live under the returned prefix's `bin/` directory. Add that directory to the shell's `PATH`, start a new shell, then rerun:
```bash
command -v openwiki
openwiki --help
```
For pnpm, initialize its home and follow the printed shell instructions:
```bash
pnpm setup
```
Do not guess or hard-code a global directory; Node version managers and package-manager configurations move it.
## Update
```bash
npm install -g openwiki@latest
npm list -g --depth=0 openwiki
openwiki --help
```
With pnpm:
```bash
pnpm update -g openwiki
openwiki --help
```
Updating the CLI does not update a generated wiki. Run `openwiki --update` separately inside each repository, or `openwiki personal --update` for the personal wiki.
## Uninstall
```bash
npm uninstall -g openwiki
```
Or:
```bash
pnpm remove -g openwiki
```
Uninstalling the package does not remove generated repository `openwiki/` directories or user data under `~/.openwiki/`. Delete those only when explicitly requested and after checking for credentials, connector data, and documentation that must be retained.
## Installation Validation
```bash
node --version
npm list -g --depth=0 openwiki
openwiki --help
```
Do not initialize a repository merely to test installation: `openwiki --init` writes documentation and modifies OpenWiki-owned blocks in root agent instruction files.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |