Reference
Features
Everything artoo 0.10.1 does: how you reach it, and when it arrived.
Artifacts Writing pages Site libraries Data and evidence Checking a build Reviewing and serving Publishing For agents Code maps Each row says how you reach a feature, as a command or a manifest setting, and the release it arrived in. Names link to the reference that explains it.
Artifacts
Feature What it does How Since An artifact A directory with a manifest, a publishable site/ and a private work/: a piece of presentation that lives beside the research behind it, in the repo that owns the subject. — 0.1.0 Start one Scaffolds the manifest, a starter page, the vendored kit and a private brief, plus working rules for agents. init PATH --kind K --form F0.1.0 Kinds and forms What it's about (explainer, report, walkthrough, presentation, case study, explorer, note…) is separate from how it's read: article, collection, explorer or deck. init --kind · --form0.5.0 Status Manifest health, what the firewall would publish, and library drift, for one artifact. status0.1.0 Every artifact in a repo Find all artifacts under a folder, and a coherence report across them. list · doctor0.1.0
Writing pages
Feature What it does How Since Write in Markdown Article and collection pages render from Markdown into deterministic, accessible shells; delete [content] to own the HTML instead. [content] source · pages0.5.0 Images and figures An image on its own line becomes a figure, with its title as the caption and alt text checked. — 0.8.0 Video loops A video in an image line becomes a silent, named loop with a poster, paused for readers who prefer less motion. — 0.9.0 Toggle figures Two to four images or loops the reader flips between, in pure CSS. — 0.9.0 Tables Pipe tables, with numeric columns and a scroll region so a wide table never widens the page. — 0.9.0 Page front matter Each page can set its own description, kicker and social card image. — 0.9.0 Blocks ::: callout, stats, pullquote, figure, wide, cards and lede, checked at build time and reported by line when written wrong. — 0.10.0 Data tables from a pack ::: grid data=PACK draws a table from a data pack, with its columns checked against the data, so no figure is retyped. — 0.10.0 HTML islands ::: html is the escape hatch: raw HTML copied verbatim, still under every check. — 0.10.0 Diagrams Mermaid fences render offline as diagrams that follow the theme and re-lay themselves on narrow screens. — 0.7.0 Named looks editorial, ledger, broadsheet or field: token sets that hold contrast in light and dark, so artifacts needn't all read as one product. look = "ledger"0.10.0
Site libraries
Feature What it does How Since artoo-kit Article layout, figures, callouts, cards, the provenance panel and light/dark, with a documented class vocabulary. — 0.1.0 artoo-deck Slides as a deck: acts, speaker notes, overview, keyboard and touch, landscape print. — 0.4.0 artoo-grid Dense comparison tables with sorting, frozen columns, in-cell bars and heat, CSV export, and missing values that never read as zero. — 0.5.0 artoo-controls Explorer controls: search, filters, chips, result counts, URL state, CSV, saved configurations. — 0.5.0 artoo-diagrams Mermaid-syntax diagrams rendered offline by a pinned, auditable Pele build. — 0.7.0 artoo-map An offline, interactive code map: focus, paths, truth layers, exports. — 0.6.0 Vendored, pinned, offline Every runtime asset is copied in with a hash; nothing loads from a CDN, so an artifact opens from a file. lib add · vendor URL · update · status0.1.0
Data and evidence
Feature What it does How Since Data packs One private JSON source becomes publishable JSON and a file://-safe script global. [[data]]0.5.0 Evidence and provenance Claims on the page link to their sources in a provenance panel, from any provider. — 0.5.0 Flip notebooks Attach a research notebook: project its claims onto the page, and route feedback back into it. provenance · feedback0.2.0 Chart guidance Record a Vizier guide for the charts in an artifact. vizier-guide0.2.0
Checking a build
Feature What it does How Since Build Runs your build commands, renders the pages, packs the data, vendors what's needed, and verifies the result. build0.1.0 Static checks Links, anchors, assets, duplicate ids, alt text, remote dependencies, data JSON. verify0.2.0 No invented classes A class guessed inside a library's namespace fails the build and names the nearest real one, or the library update it needs. — 0.5.0 Browser checks Every page in Chromium at phone and desktop width: errors, overflow naming the element, broken images, contrast, tiny or clipped text. build · verify --browser0.10.0 Contact sheet Every page at desktop and phone, side by side, in one image. — 0.10.0 Design lint Named rules for pages that look generated: raw colours, foreign fonts, gradient text, glass, emoji icons, stock copy. — 0.10.0
Reviewing and serving
Feature What it does How Since Review against the render A finding or its fix, bound to exactly the files the page serves and the Git head. review ART "finding" --page P · --resolves ID0.7.0 Serve it locally Runs the artifact the way a deploy would show it: a withheld file is absent, not just unlinked. serve0.5.0 Saved state Named JSON documents a page saves through serve, kept in the artifact's state/ folder, with conflict checks. [state] collections0.7.0
Publishing
Feature What it does How Since The firewall Only site/ publishes. Research, briefs and state sit beside it and can't ship by accident. — 0.1.0 Deploy Firewall-staged, then handed to an adapter: GitHub Pages (docs, workflow or branch), rsync, or a command. deploy0.1.0
For agents
Feature What it does How Since Working rules for agents Each artifact carries a short AGENTS.md and an on-demand ARTOO_REFERENCE.md generated from the libraries it actually vendored. — 0.5.0 The reference, offline artoo docs prints the golden path, the manifest, every block and every library's vocabulary. docs [topic]0.5.0 Install as a skill Installs artoo's contract as an agent skill. skill0.5.0 llms.txt The whole reference for language models, published beside the site. — 0.5.0 Generators Plugins that write artifacts: an explainer for a repo, and a report from a notebook. generate NAME0.1.0 Workers Tiered delegation to local agent CLIs for analysis and synthesis. — 0.1.0 Plugins Generators, deploy adapters and site libraries are entry points, so others can add their own. — 0.1.0
Code maps
Feature What it does How Since Code graphs artoo map build records a repository's structure with evidence: source coordinates, truth classes, receipts. map build0.6.0 Ask the graph view, why, path and context answer bounded questions about a codebase, with the evidence behind each answer. map view · why · path · context0.6.0 Exports Mermaid, JSON and SVG views of the same selection; Mermaid is an export, not the source of truth. map view --format0.6.0
48 features, from site/landing/work/features.json. The changelog has the detail.