mhmtsrfglu/superwiki

Superwiki

Agent skills that turn a project's docs/ folder into an LLM-maintained wiki and task tracker. Your coding agent writes it and keeps it current; you read it as an Obsidian vault or in a built-in viewer. Works with Claude Code, Codex CLI and GitHub Copilot CLI.

Live demo · Install · Use · Design notes

<picture> <source media="(prefers-color-scheme: dark)" srcset="assets/viewer-waves-dark.png"> <img alt="The Superwiki viewer: task counts per area, filters, and the dependency board with one task's chain highlighted" src="assets/viewer-waves-light.png"> </picture>

Quick start

Requires Node 18 or newer.

npx superwiki install claude        # or: codex, copilot, all

Start a new agent session in your project and run /sw:init. It sets up docs/ and asks whether you want the task tracker. From then on, ask for what you need in plain words, or use a command.

What you get

docs/
  index.md       the open tasks, then the catalog of the wiki, one line per page
  log.md         append-only history
  raw/           your sources, never modified
  wiki/          pages the agent writes
  tasks/         one file per task (optional)
  plans/         one plan per task
  viewer.html    the task board and the wiki in a browser

sw:init also adds a short block of rules to AGENTS.md, so the agent maintains the vault in every session, with or without a command.

Everything is plain markdown. docs/ keeps working as an Obsidian vault without Superwiki.

The wiki

Superwiki follows the LLM Wiki pattern described by Andrej Karpathy: you curate raw sources, the agent owns the wiki, and a short set of rules tells it how to maintain it. Hand the agent an article, a transcript or your notes, and it files a summary and links it into the catalog.

The tasks

A task is one file with a goal, a "Done when" list and its dependencies. The