boykush/scraps
boykush/scraps has 45 GitHub stars and 6 forks. GitHot measured 0 stars in 24 hours, 0 in 7 days, and 0 in 15 days. Last checked 2026-11-22 11:43 UTC. Last push 2026-11-22.
Progression mesurée des étoiles
- in 24h
- 0
- in 7 days
- 0
- in 15 days
- 0
- in 1 month
- Historique en cours
Variations nettes sur des périodes qui se chevauchent, pas des totaux quotidiens. Les mesures absentes restent vides. Les étoiles indiquent l’intérêt, pas la qualité.
À propos
The Wiki-link doc compiler for the LLM era.
Outils de développementREADME.md
Original
Scraps
The Wiki-link doc compiler for the LLM era.
Scraps treats documentation like a programming language. Wiki-linked markdown becomes a typed source, compiling into a static site for readers and into JSON any agent can shell into — turning Karpathy's LLM Wiki pattern into a typed, queryable artifact. CLI primary with companion AI skills, fitting any editor and any LLM agent.
Quick start
# Install
brew install boykush/tap/scraps # or: cargo install scraps
# Compile a wiki
mkdir my-wiki && cd my-wiki
scraps init
scraps build
# Query the same source from a shell or AI agent
scraps search "release checklist" --json
scraps links "Configuration" --json
scraps lint
See the Getting Started tutorial for the full flow.
How it works
graph LR
Source[Markdown sources] --> IR[Scraps IR — typed graph]
IR --> HTML[Static HTML]
IR --> JSON[CLI JSON]
Scraps reads [[wiki-link]], #[[tag]], ![[embed]], [[Page#heading]], and ctx_path as typed primitives. The same source compiles to an HTML site for human readers and to JSON for scripts and AI agents. The IR is kept under .scraps/ next to .scraps.toml, so every command reads the wiki through it and an unchanged source is never parsed twice.
AI integration
CLI + JSON is the primary path — any shell-capable agent can query Scraps without an MCP client implementation. Bundled plugins provide agent-facing workflows:
llm-wiki— Karpathy-style Ingest / Query / Lint skills for Claude Code and Codex, plus Claude Code agents for purpose-driven lint and the default Scraps LLM Wiki schemapkm— Personal knowledge management skills for Claude Code: learn a source and record only what you understood, or digest an article into a short linked pagemcp-server— MCP server for MCP-compatible clients, shared across repositories viascraps mcp serve --http
See the AI integration guide for the trade-offs.
Documentation
- Documentation site — Tutorial, How-to, Reference, Explanation
- Sample wiki — Japanese knowledge base built with Scraps
Screenshots

Search, pagination, and Wiki-link navigation, themed with Nord.

Each scrap page draws its neighbourhood: backlinks on the left, links on the right, arrows pointing at the referenced scrap.
Light mode
Contributing
Bugs, feature requests, and PRs are welcome. See CONTRIBUTING.md, the issue templates, and the Code of Conduct.
License
MIT
Explorer des projets similaires
Chargement…