Tesserae v0.6.0 — 水晶のように澄んだ CLI

<!-- translations:start -->

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

<!-- translations:end -->

リリース日 2026-06-08 · PyPI · GitHub release · pip install --upgrade tesserae==0.6.0

Tesserae 0.6.0 は CLI の再設計 です。エンジンが行うすべてが tesserae project <26 個の隠れたサブコマンド> の下に埋もれ、setup には 29 個、compile には 26 個のフラグがあり、素の tesserae を実行すると生の抽出パーサが吐き出されていました。0.6.0 はそれを フラットな動詞のコマンドツリー に置き換えます —— 日常的な動詞を最上位に、少数の小さな名詞グループ、グループ化されたヘルプ、そしてすべてのコマンドに EXAMPLES を備えます。これは 破壊的変更 であり、1.0 以前であることを踏まえて意図的に踏み切ったものです。古いコマンドは黙ってエイリアスにはならず、一行の … has moved → … リダイレクトを出力して終了コード 2 で終わります。そのため移行は不可解ではなく、明白になります。エンジン、グラフ、MCP ツール、tesserae_mcp サーバーは変更されていません —— このリリースは、人間が入力する表面に関するものに徹しています。

目次:

1. 新しいコマンドツリー
2. ダイエットした MD0 と MD1
3. きっぱりとした移行 —— 黙ったエイリアスなし
4. v0.5.0 からのアップグレード

1. 新しいコマンドツリー

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

• 日常的な動詞は最上位にあります。 tesserae compile、tesserae serve、tesserae ask、tesserae context "…" —— project 接頭辞はありません。
• status は新しく追加された読み取り専用のサマリです（ノード/エッジ数、最後のコンパイル、vault、サイト）。
• serve はサイトが存在しないか古い場合に自動でビルドします（--no-build でスキップ）。
• 専門コマンドは小さな名詞グループに収まっています: 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 は旧来の build-site、deploy（--deploy）、watch（--watch）の各動詞を取り込みます。
• グループ化されたルートヘルプ + EXAMPLES —— 引数なしで tesserae を実行するとグループ化されたツリーが表示され、すべてのコマンドの --help は実際に実行可能な例で終わります。

2. ダイエットした init と compile

• init: 29 → 8 フラグ。 既定ではウィザード方式で、--yes は非対話的に実行します（オプションの統合 —— Cognee、RAG-Anything、Understand-Anything —— は既定で オフ、また TTY でなければ色が自動的に無効化され、旧来の --no-color/--no-cognee/--skip-* フラグを包含します）。--bare はウィザードなしでワークスペースを書き出します。LLM バックエンドのフラグ（--llm-provider、--claude-config-dir、--codex-home）は残ります。
• compile: 26 → 8 フラグ。 日常的なフラグは残ります（--changed-only、--no-sessions、--limit、--refresh-integrations、3 つの LLM フラグ、そしてアドホックな compile <paths>）。削除されたすべての統合ノブ（kuzu/cognee/trends/vault-pull/…）は .tesserae/config.json の compile_options ブロックへ同じ名前で移され、旧来の既定値が保持されています —— したがって挙動は同一で、表面が静かになっただけです。compile_options の完全な表はクイックスタートを参照してください。

3. きっぱりとした移行 —— 黙ったエイリアスなし

すべてのレガシー呼び出しは、ちょうど一行を出力して終了コード 2 で終わります:

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

このリダイレクト表は、すべての古いコマンドを網羅します（project sessions import のような 3 トークン形式や、旧来の wiki/llm-defaults の最上位コマンドを含む）。そして素の markdown パス（tesserae notes/x.md）は tesserae extract を案内します。フック、CI スモーク、リリースフロー、そしてリポジトリ内のすべてのランタイム文字列が足並みをそろえて移行されました。ドキュメントと 8 つすべての README（さらにすべてのローカライズ版）は、いまや新しいツリーの言葉を話します。

v0.5.0 からのアップグレード

• スクリプトで使う動詞を学び直してください。 最もよくある置き換え: 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 …。コマンドの古い形式を一度実行してみてください —— … has moved → … のメッセージが新しい形を教えてくれます。
• compile のフラグを移しましたか？ compile --trends、--no-vault-pull、--cognee-* などをスクリプトに書いていた場合は、代わりに .tesserae/config.json で対応する compile_options.<key> を設定してください（表はクイックスタートにあります）。
• init の統合フラグは CLI から消えました。 Cognee / RAG-Anything / Understand-Anything を有効にするには、tesserae init ウィザードのプロンプトに答えるか、.tesserae/config.json を編集してから tesserae integrations refresh <name> を実行してください。
• グラフ、vault、サイト、MCP ツール、tesserae_mcp サーバー については何も変わっていません —— 変わったのは人間に向き合う CLI だけです。