Tesserae v0.6.0 — A crystal-clear CLI

<!-- translations:start -->

한국어 · 中文 · 日本語 · Русский · Español · Français · Deutsch

<!-- translations:end -->

Released 2026-06-08 · PyPI · GitHub release · pip install --upgrade tesserae==0.6.0

Tesserae 0.6.0 is a CLI redesign. Everything the engine does was buried under tesserae project <26 hidden subcommands>, with a 29-flag setup and a 26-flag compile; bare tesserae dumped a raw extraction parser. 0.6.0 replaces that with a flat-verb command tree — everyday verbs at the top level, a handful of small noun groups, grouped help, and EXAMPLES on every command. This is a breaking change, taken deliberately pre-1.0: old commands don't silently alias, they print a one-line … has moved → … redirect and exit 2, so the migration is obvious rather than mysterious. The engine, graph, MCP tools, and tesserae_mcp server are unchanged — this release is entirely about the surface a human types.

Table of contents:

1. The new command tree
2. MD0 and MD1 on a diet
3. Clean-break migration — no silent aliases
4. Upgrading from v0.5.0

1. The new command tree

tesserae <command>

EVERYDAY    init compile context ask serve status
AUTOMATION  engine refresh research
ANALYSIS    query lint
GROUPS      sessions vault export code config projects integrations extract
LAB         lab

• Everyday verbs are top-level. tesserae compile, tesserae serve, tesserae ask, tesserae context "…" — no project prefix.
• status is a new read-only summary (node/edge counts, last compile, vault, site).
• serve auto-builds the site when it's missing or stale (skip with --no-build).
• Specialist commands live in small noun groups: sessions import|discover|list, vault sync|export|prune|set-root|sync-all, export harness|graphiti|site, code ingest|sync, config llm|show, projects register|list|activate|unregister|mcp-config, integrations refresh <name>, extract, lab evolve|schema-drift.
• export site folds in the old build-site, deploy (--deploy), and watch (--watch) verbs.
• Grouped root help + EXAMPLES — tesserae with no args shows the grouped tree; every command's --help ends with real, runnable examples.

2. init and compile on a diet

• init: 29 → 8 flags. Wizard by default; --yes runs it non-interactively (optional integrations — Cognee, RAG-Anything, Understand-Anything — default off, and color auto-disables off a TTY, subsuming the old --no-color/--no-cognee/--skip-* flags). --bare writes the workspace without the wizard. The LLM-backend flags (--llm-provider, --claude-config-dir, --codex-home) stay.
• compile: 26 → 8 flags. The everyday flags remain (--changed-only, --no-sessions, --limit, --refresh-integrations, the three LLM flags, and ad-hoc compile <paths>). Every removed integration knob (kuzu/cognee/trends/vault-pull/…) moves to a compile_options block in .tesserae/config.json under the same name, with its old default preserved — so behavior is identical, the surface is just quiet. See the quickstart for the full compile_options table.

3. Clean-break migration — no silent aliases

Every legacy invocation prints exactly one line and exits 2:

$ tesserae project compile
tesserae project compile has moved → tesserae compile

The redirect table covers every old command (including 3-token forms like project sessions import and the old wiki/llm-defaults top-levels), and a bare markdown path (tesserae notes/x.md) points you at tesserae extract. Hooks, the CI smoke, the release flow, and all in-repo runtime strings were migrated in lockstep; the docs and all eight READMEs (plus every localized copy) now speak the new tree.

Upgrading from v0.5.0

• Re-learn the verbs you script. The most common swaps: project setup --yes … → tesserae init --yes, project compile → tesserae compile, project build-site → tesserae export site, project serve → tesserae serve, project obsidian-sync → tesserae vault sync, project sync-code → tesserae code sync, tesserae llm-defaults … → tesserae config llm …, tesserae wiki … → tesserae projects …. Run a command's old form once — the … has moved → … message tells you the new one.
• Moved a compile flag? If you scripted compile --trends, --no-vault-pull, --cognee-*, etc., set the matching compile_options.<key> in .tesserae/config.json instead (table in the quickstart).
• init integration flags are gone from the CLI. Enable Cognee / RAG-Anything / Understand-Anything by answering the tesserae init wizard prompts, or by editing .tesserae/config.json and running tesserae integrations refresh <name>.
• Nothing about the graph, vault, site, MCP tools, or tesserae_mcp server changed — only the human-facing CLI.