{"_id":"@alekra1/llm-wiki","_rev":"2-a839d26453fb181535238dd213a97383","name":"@alekra1/llm-wiki","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@alekra1/llm-wiki","version":"1.0.0","keywords":["llm","claude","agents","wiki","memory","context","claude-code"],"license":"MIT","_id":"@alekra1/llm-wiki@1.0.0","maintainers":[{"name":"alekra1","email":"alekseyuwww12@gmail.com"}],"homepage":"https://github.com/Alekra1/llm-wiki#readme","bugs":{"url":"https://github.com/Alekra1/llm-wiki/issues"},"bin":{"llm-wiki":"bin/setup.js"},"dist":{"shasum":"6fe1b49c74281d70d65db8fe21e0ccd96414597d","tarball":"https://registry.npmjs.org/@alekra1/llm-wiki/-/llm-wiki-1.0.0.tgz","fileCount":22,"integrity":"sha512-oJkZqFjHYG3Sp8VgBAZjI9XQwXEew0Pr7sFVBve6JvpFipPNYCakAPrWK6oIUpTLdKkSEMvVP8fu6dw7zcoBkQ==","signatures":[{"sig":"MEUCICWbLF421i+K+KxOybETxfgsTZTfhYwMu6YmpQQ+hlMzAiEA1/vWU4nGg0TgasihEA8iCFIT7aHBXWpRPA9+a+17HXo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":28831},"engines":{"node":">=14"},"gitHead":"8a7605718e544e579fa71d545f21278e80b137d2","_npmUser":{"name":"alekra1","email":"alekseyuwww12@gmail.com"},"repository":{"url":"git+https://github.com/Alekra1/llm-wiki.git","type":"git"},"_npmVersion":"11.6.2","description":"Markdown wiki template for LLM agent persistent memory. Gives agents cross-session, cross-provider memory.","directories":{},"_nodeVersion":"25.2.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/llm-wiki_1.0.0_1778589786059_0.6261128614939635","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@alekra1/llm-wiki","version":"1.0.1","description":"Markdown wiki template for LLM agent persistent memory. Gives agents cross-session, cross-provider memory.","bin":{"llm-wiki":"bin/setup.js"},"keywords":["llm","claude","agents","wiki","memory","context","claude-code"],"license":"MIT","repository":{"type":"git","url":"git+https://github.com/Alekra1/llm-wiki.git"},"engines":{"node":">=14"},"gitHead":"99e2ff738f31557d545bec4ad2695c25743daac9","_id":"@alekra1/llm-wiki@1.0.1","bugs":{"url":"https://github.com/Alekra1/llm-wiki/issues"},"homepage":"https://github.com/Alekra1/llm-wiki#readme","_nodeVersion":"25.2.1","_npmVersion":"11.6.2","dist":{"integrity":"sha512-ncEIeNfGwegow23V/T9RQHvutP9gqlTE2KrIRL+rO0pDpJpklSAMiG+0cG9XjLNfvyaRTPNI73DOZHDYQL/nPg==","shasum":"3e75b0b2ec3da289cdfe4ee35703b20220517893","tarball":"https://registry.npmjs.org/@alekra1/llm-wiki/-/llm-wiki-1.0.1.tgz","fileCount":22,"unpackedSize":31663,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCvOGk/NPfnuxIUxnQrKSk9Up5MeZ9t/O07+z5iAdLVKgIhAPRTZEBlMmuu7OocgBaIsoo7Z2V61KGRM7uyChJNVMZ5"}]},"_npmUser":{"name":"alekra1","email":"alekseyuwww12@gmail.com"},"directories":{},"maintainers":[{"name":"alekra1","email":"alekseyuwww12@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/llm-wiki_1.0.1_1778592002792_0.5875701792358616"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-12T12:43:05.982Z","modified":"2026-05-12T13:20:03.077Z","1.0.0":"2026-05-12T12:43:06.231Z","1.0.1":"2026-05-12T13:20:02.960Z"},"bugs":{"url":"https://github.com/Alekra1/llm-wiki/issues"},"license":"MIT","homepage":"https://github.com/Alekra1/llm-wiki#readme","keywords":["llm","claude","agents","wiki","memory","context","claude-code"],"repository":{"type":"git","url":"git+https://github.com/Alekra1/llm-wiki.git"},"description":"Markdown wiki template for LLM agent persistent memory. Gives agents cross-session, cross-provider memory.","maintainers":[{"name":"alekra1","email":"alekseyuwww12@gmail.com"}],"readme":"# llm-wiki\n\nGives LLM agents persistent, cross-session memory — a markdown wiki that agents read and write as a living brain. Survives context resets and provider switches. Zero tooling required.\n\n## Install\n\n**Step 1 — scaffold the wiki into your project:**\n\n```bash\nnpx @alekra1/llm-wiki\n```\n\nThis copies `wiki/` into your project, creates or appends to `CLAUDE.md`, and adds provider files (`AGENTS.md`, `GEMINI.md`, `.cursorrules`) if they don't already exist. Safe to run on existing projects — never overwrites.\n\n**Step 2 — install the Claude Code plugin** (slash commands + session hooks):\n\n```\n/plugin marketplace add Alekra1/llm-wiki\n/plugin install wiki@llm-wiki\n```\n\n**Step 3 — fill in the snapshot:**\n\nOpen `wiki/_snapshot.md` and replace the placeholders with your project's current state. This is what the agent reads first every session.\n\nThat's it. Start a Claude Code session.\n\n---\n\n## How it works\n\nOn session start, the SessionStart hook fires automatically and the agent reads `wiki/_snapshot.md` — one page, ~300 tokens, ~30 seconds. It picks up exactly where the last session ended.\n\nAs you work, the agent writes to the wiki: decisions in `wiki/decisions/`, preferences in `wiki/preferences/`, current task in `wiki/_active/`. Every change gets a line in `wiki/log.md`.\n\nAt session end, a Stop hook checks whether `wiki/log.md` was updated. If not, it prints a reminder in the terminal. The next SessionStart automatically catches any gaps from the previous session.\n\n---\n\n## Wiki structure\n\n```\nwiki/\n├── _snapshot.md          ← read first every session (~300 tokens)\n├── _active/\n│   ├── now.md            ← current task and blockers\n│   └── open-questions.md ← unresolved questions\n├── decisions/            ← technical and design decisions\n├── preferences/          ← user preferences (style, tools, communication)\n├── workflows/            ← repeatable processes\n├── pitfalls/             ← known traps and how to avoid them\n├── architecture/         ← system overviews\n├── index.md              ← catalog of all pages\n├── log.md                ← append-only session log\n├── HOWTO.md              ← full wiki conventions\n└── EXAMPLES.md           ← format examples for each page type\n```\n\n---\n\n## Slash commands (Claude Code)\n\nInstalled by the CC plugin.\n\n| Command | What it does |\n|---|---|\n| `/wiki-update` | Write a structured wiki entry (routes to correct location automatically) |\n| `/wiki-snapshot` | Rewrite `_snapshot.md` to reflect current state |\n| `/wiki-lint` | Run the wiki health checklist — orphans, stale pages, contradictions, duplicates |\n\n---\n\n## Provider support\n\n`npx @alekra1/llm-wiki` installs entry-point files for every major provider:\n\n| File | Provider |\n|---|---|\n| `CLAUDE.md` | Claude Code |\n| `AGENTS.md` | OpenAI Agents, Codex |\n| `GEMINI.md` | Gemini |\n| `.cursorrules` | Cursor |\n\nEach file contains identical wiki instructions in the format that provider expects. The CC plugin (slash commands + hooks) is Claude Code only — other providers use the wiki via file reads without the plugin.\n\n---\n\n## Existing projects\n\n`npx @alekra1/llm-wiki` is conflict-safe:\n\n- `wiki/` — skipped if it already exists\n- `CLAUDE.md` — wiki block appended if not already present, never overwritten\n- `AGENTS.md`, `GEMINI.md`, `.cursorrules` — created only if absent\n\nThe CC plugin installs alongside your existing `.claude/settings.json` without touching it.\n\n---\n\n## Conventions\n\nRead `wiki/HOWTO.md` for the full conventions: page format, supersession rules, log format, index discipline, snapshot discipline, and lint checklist.\n","readmeFilename":"README.md"}