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/personal-mode.md
View on GitHub# OpenWiki Personal Mode
## Initialize
```bash
openwiki personal --init
```
Personal mode writes the synthesized wiki to `~/.openwiki/wiki` and stores global instructions in `~/.openwiki/INSTRUCTIONS.md`. Onboarding configures the model provider, optional LangSmith tracing, sources, templates, ingestion notes, and optional schedules.
| Path | Contents |
| --- | --- |
| `~/.openwiki/wiki/` | Personal Markdown wiki |
| `~/.openwiki/INSTRUCTIONS.md` | Global personal-wiki brief |
| `~/.openwiki/onboarding.json` | Preferences, source instances, notes, schedules |
| `~/.openwiki/connectors/<source>/raw/` | Deterministically fetched source data and manifests |
| `~/.openwiki/.env` | Provider and connector secrets |
## Supported Sources
| Source | Authentication |
| --- | --- |
| Local git repositories | Local paths |
| Gmail | Google OAuth |
| Notion | Hosted MCP OAuth |
| Slack | App client credentials plus OAuth and HTTPS callback |
| X/Twitter | OAuth 2.0 with PKCE |
| Web search | `TAVILY_API_KEY` |
| Hacker News | None |
Multiple instances of one source are supported, such as `web-search-1` and `web-search-2`.
## Authenticate Connectors
List supported providers and status:
```bash
openwiki auth
```
Run browser authentication where required:
```bash
openwiki auth notion
openwiki auth gmail
openwiki auth x
openwiki auth slack
```
Advanced auth helpers:
```bash
openwiki auth configure <provider> --force
openwiki auth tools <provider>
```
Slack OAuth may require an HTTPS callback tunnel:
```bash
openwiki ngrok start
openwiki ngrok start https://your-domain.ngrok.app
```
Never put secret values in connector configuration. OpenWiki references environment-variable names and stores local secrets in `~/.openwiki/.env`.
## Ingest Sources
```bash
openwiki ingest all
openwiki ingest web-search
openwiki ingest web-search-2
```
An ingestion run first writes raw connector data, then source-specific agent runs synthesize wiki updates. Refresh all configured personal sources with:
```bash
openwiki personal --update
openwiki personal --update "Refresh the wiki from configured connectors"
```
Use interactive personal chat for follow-ups:
```bash
openwiki personal
```
## Visualize
```bash
openwiki visualize ~/.openwiki/wiki
```
The visualizer binds to loopback only. It still loads browser libraries from a public CDN.
## Manage Schedules On macOS
OpenWiki can install personal-source schedules as user LaunchAgents under `~/Library/LaunchAgents/`; logs go under `~/.openwiki/logs/`.
```bash
openwiki cron list
openwiki cron pause <source|all>
openwiki cron resume <source|all>
openwiki cron delete <source|all>
```
Deleting a schedule unloads its LaunchAgent and removes schedule metadata. It does not delete authentication, connector configuration, raw data, or wiki content.
## Data And Credential Boundaries
- `~/.openwiki` should be user-only (`0o700`); `~/.openwiki/.env` should be `0o600`.
- Review each connector's permissions and data scope before authentication.
- Keep connector raw data out of source repositories and backups that lack equivalent protection.
- Revoke OAuth grants at the provider when a connector is no longer used.
- Remove saved local tokens only after confirming which source instances depend on them.
- Treat personal wiki output as sensitive because synthesis may combine information from several sources.
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 |