clawed 2.5.3__tar.gz → 3.0.0__tar.gz

{clawed-2.5.3 → clawed-3.0.0}/.gitignore

@@ -18,6 +18,7 @@ build/
 !examples/**/*.json
 !eduagent/demo/*.json
 !clawed/demo/*.json
+!cli/**/*.json
 eduagent_output/
 clawed_output/
 eduagent_data/
@@ -38,6 +39,13 @@ clawed_data/
 htmlcov/
 .ruff_cache/
 
+# CLI (TypeScript/Ink build)
+cli/node_modules/
+cli/dist/
+cli/.bun/
+cli/source/cli.js
+cli/source/cli.js.map
+
 # Build prompts (internal)
 BUILD_PROMPT.md
 

{clawed-2.5.3 → clawed-3.0.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: clawed
-Version: 2.5.3
-Summary: Free AI lesson planner for teachers. Learns your teaching voice from your curriculum files and generates complete lesson packages. Open source, runs locally, no subscription.
+Version: 3.0.0
+Summary: Your AI co-teacher. Generate lessons, games, slides, and assessments from your terminal. Learns your teaching voice, aligns to your state standards, and works with any LLM provider.
 Project-URL: Homepage, https://sirhanmacx.github.io/Claw-ED
 Project-URL: Documentation, https://github.com/SirhanMacx/Claw-ED#readme
 Project-URL: Repository, https://github.com/SirhanMacx/Claw-ED
@@ -12,7 +12,7 @@ Author: Jon Maccarello & Claw-ED contributors
 License-Expression: MIT
 License-File: LICENSE
 Keywords: ai,ai-for-teachers,claw-ed,clawed,curriculum,edtech,education,hermes-agent,k12,lesson-plan-generator,lesson-planner,lesson-planning,lesson-plans,open-source-education,pedagogy,teacher-tools,teachers,teaching,teaching-assistant
-Classifier: Development Status :: 3 - Alpha
+Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Education
 Classifier: License :: OSI Approved :: MIT License
@@ -74,9 +74,9 @@ Provides-Extra: voice
 Requires-Dist: faster-whisper>=0.10.0; extra == 'voice'
 Description-Content-Type: text/markdown
 
-# Claw-ED
+# Claw-ED v3
 
-**Your AI co-teacher. Learns your voice. Generates lessons that sound like you wrote them.**
+**The agentic layer for education. Your AI co-teacher that lives in the terminal.**
 
 <p align="center">
   <a href="https://pypi.org/project/clawed/"><img src="https://img.shields.io/pypi/v/clawed?color=blue" alt="PyPI version"></a>
@@ -88,7 +88,9 @@ Description-Content-Type: text/markdown
 
 ---
 
-Claw-ED is an open-source AI teaching assistant that learns your actual teaching style from your curriculum files. Not a generic lesson template generator — a personal agent that captures your voice, your scaffolding patterns, your assessment style, and your classroom personality. It generates complete lesson packages that your colleagues would swear you wrote yourself.
+Claw-ED v3 is a persistent AI teaching assistant that lives in your terminal and on your phone. Talk naturally — "make me a lesson on WWI for my 8th graders" — and it generates complete lesson packages in your voice. Not a chatbot. An agent that knows your curriculum, your standards, your students, and your teaching style.
+
+**New in v3:** Beautiful interactive terminal (Ink TUI), always-on Telegram bot, multi-provider LLM support (Anthropic, OpenAI, Google, Ollama), natural language routing.
 
 ```bash
 pip install clawed
@@ -195,7 +197,9 @@ Your curriculum files (PDF, DOCX, PPTX, and 20+ formats)
 | `clawed standards list -g 8 -s "Math"` | Browse state standards |
 | `clawed gap-analyze` | Find curriculum gaps |
 | `clawed train --benchmark -n 5` | Score lesson quality |
-| `clawed bot --token TOKEN` | Connect Telegram bot |
+| `clawed daemon start` | Start always-on Telegram bot (background) |
+| `clawed daemon stop` | Stop the Telegram daemon |
+| `clawed daemon status` | Show daemon uptime and health |
 | `clawed serve` | Web dashboard |
 | `clawed mcp-server` | MCP server (for Claude Code integration) |
 | `clawed game create "Topic" -g 8` | Generate an interactive HTML learning game |
@@ -280,28 +284,33 @@ Claw-ED can work while you sleep:
 ## Architecture
 
 ```
-Teacher (Telegram, CLI, Web, MCP)
+Teacher (Terminal or Phone)
+       |
+  ┌────┴─────┐
+  │ Ink TUI  │  ←── Beautiful interactive terminal (TypeScript)
+  │  or      │
+  │ Telegram │  ←── Always-on thin client via background daemon
+  └────┬─────┘
+       |
+  Multi-Provider LLM Router
+  (Anthropic | OpenAI | Google | Ollama)
+       |
+  ↕ tool_use / function_calling
+       |
+  14 Claw-ED Tools (TypeScript → Python subprocess)
+       |
+  Python Engine (lesson, game, export, standards, persona, ...)
        |
-   Gateway (feature-flag router)
-   |-- Control Plane (deterministic: files, onboarding, export)
-   |-- Agent Loop (LLM with 28 typed tools)
-              |                        |
-       Tool Registry              Workspace
-       - generate_lesson          - SOUL.md (identity)
-       - search_materials         - HEARTBEAT.md (schedule)
-       - generate_assessment      - Memory (3-layer cognitive)
-       - curriculum_map           |
-       - export_document     Curriculum KB
-       - 23 more tools       (semantic search over your files)
-              |
-       Professional exports (DOCX, PPTX, PDF, Google Docs)
+  Professional exports (DOCX, PPTX, HTML games, PDF)
 ```
 
 **Key design decisions:**
 
 - **Agent-first.** Natural language goes through an LLM that decides which tools to call. No rigid command parsing.
 - **Master Content Track.** One LLM generation produces a unified `MasterContent` object. Teacher view, student packet, and slideshow are compiled mechanically — no redundant AI calls.
-- **Fail-closed quality gates.** Every generation is validated. If quality review crashes, it reports failure instead of silently passing.
+- **Subprocess bridge.** TypeScript CLI calls Python engine via `python3 -m clawed <cmd> --json`. Clean separation, independent testing, single install.
+- **Multi-provider.** Teacher picks their provider (free Ollama to premium Claude). Claw-ED picks the best model within it.
+- **Always-on daemon.** Background process keeps Telegram bot online. Teachers generate lessons from their phone.
 - **Subject-specific skills.** 13 built-in subject skills (Math, Science, History, ELA, Music, Art, PE, CS, Foreign Language, Library, Special Ed, and more) tune the generation for each discipline's pedagogy.
 
 ---
@@ -376,7 +385,7 @@ Claw-ED is built by a teacher for teachers. Join the conversation:
 - **[Report issues](https://github.com/SirhanMacx/Claw-ED/issues)** — bugs, feature requests, quality feedback
 - **[Star the repo](https://github.com/SirhanMacx/Claw-ED)** — it helps other teachers find us
 
-14,000+ installs and growing. If Claw-ED saved you prep time, tell a colleague.
+14,000+ installs and growing. The agentic layer for education starts here.
 
 ---
 
@@ -384,6 +393,6 @@ Claw-ED is built by a teacher for teachers. Join the conversation:
 
 MIT License. Free for personal and commercial use.
 
-Built by educators, for educators.
+Built by educators, for educators. The agentic layer for education.
 
-[GitHub](https://github.com/SirhanMacx/Claw-ED) | [PyPI](https://pypi.org/project/clawed/) | [Discussions](https://github.com/SirhanMacx/Claw-ED/discussions) | [Changelog](CHANGELOG.md)
+[GitHub](https://github.com/SirhanMacx/Claw-ED) | [PyPI](https://pypi.org/project/clawed/) | [Game Gallery](https://sirhanmacx.github.io/Claw-ED/games) | [Discussions](https://github.com/SirhanMacx/Claw-ED/discussions) | [Changelog](CHANGELOG.md)

{clawed-2.5.3 → clawed-3.0.0}/README.md

@@ -1,6 +1,6 @@
-# Claw-ED
+# Claw-ED v3
 
-**Your AI co-teacher. Learns your voice. Generates lessons that sound like you wrote them.**
+**The agentic layer for education. Your AI co-teacher that lives in the terminal.**
 
 <p align="center">
   <a href="https://pypi.org/project/clawed/"><img src="https://img.shields.io/pypi/v/clawed?color=blue" alt="PyPI version"></a>
@@ -12,7 +12,9 @@
 
 ---
 
-Claw-ED is an open-source AI teaching assistant that learns your actual teaching style from your curriculum files. Not a generic lesson template generator — a personal agent that captures your voice, your scaffolding patterns, your assessment style, and your classroom personality. It generates complete lesson packages that your colleagues would swear you wrote yourself.
+Claw-ED v3 is a persistent AI teaching assistant that lives in your terminal and on your phone. Talk naturally — "make me a lesson on WWI for my 8th graders" — and it generates complete lesson packages in your voice. Not a chatbot. An agent that knows your curriculum, your standards, your students, and your teaching style.
+
+**New in v3:** Beautiful interactive terminal (Ink TUI), always-on Telegram bot, multi-provider LLM support (Anthropic, OpenAI, Google, Ollama), natural language routing.
 
 ```bash
 pip install clawed
@@ -119,7 +121,9 @@ Your curriculum files (PDF, DOCX, PPTX, and 20+ formats)
 | `clawed standards list -g 8 -s "Math"` | Browse state standards |
 | `clawed gap-analyze` | Find curriculum gaps |
 | `clawed train --benchmark -n 5` | Score lesson quality |
-| `clawed bot --token TOKEN` | Connect Telegram bot |
+| `clawed daemon start` | Start always-on Telegram bot (background) |
+| `clawed daemon stop` | Stop the Telegram daemon |
+| `clawed daemon status` | Show daemon uptime and health |
 | `clawed serve` | Web dashboard |
 | `clawed mcp-server` | MCP server (for Claude Code integration) |
 | `clawed game create "Topic" -g 8` | Generate an interactive HTML learning game |
@@ -204,28 +208,33 @@ Claw-ED can work while you sleep:
 ## Architecture
 
 ```
-Teacher (Telegram, CLI, Web, MCP)
+Teacher (Terminal or Phone)
+       |
+  ┌────┴─────┐
+  │ Ink TUI  │  ←── Beautiful interactive terminal (TypeScript)
+  │  or      │
+  │ Telegram │  ←── Always-on thin client via background daemon
+  └────┬─────┘
+       |
+  Multi-Provider LLM Router
+  (Anthropic | OpenAI | Google | Ollama)
+       |
+  ↕ tool_use / function_calling
+       |
+  14 Claw-ED Tools (TypeScript → Python subprocess)
+       |
+  Python Engine (lesson, game, export, standards, persona, ...)
        |
-   Gateway (feature-flag router)
-   |-- Control Plane (deterministic: files, onboarding, export)
-   |-- Agent Loop (LLM with 28 typed tools)
-              |                        |
-       Tool Registry              Workspace
-       - generate_lesson          - SOUL.md (identity)
-       - search_materials         - HEARTBEAT.md (schedule)
-       - generate_assessment      - Memory (3-layer cognitive)
-       - curriculum_map           |
-       - export_document     Curriculum KB
-       - 23 more tools       (semantic search over your files)
-              |
-       Professional exports (DOCX, PPTX, PDF, Google Docs)
+  Professional exports (DOCX, PPTX, HTML games, PDF)
 ```
 
 **Key design decisions:**
 
 - **Agent-first.** Natural language goes through an LLM that decides which tools to call. No rigid command parsing.
 - **Master Content Track.** One LLM generation produces a unified `MasterContent` object. Teacher view, student packet, and slideshow are compiled mechanically — no redundant AI calls.
-- **Fail-closed quality gates.** Every generation is validated. If quality review crashes, it reports failure instead of silently passing.
+- **Subprocess bridge.** TypeScript CLI calls Python engine via `python3 -m clawed <cmd> --json`. Clean separation, independent testing, single install.
+- **Multi-provider.** Teacher picks their provider (free Ollama to premium Claude). Claw-ED picks the best model within it.
+- **Always-on daemon.** Background process keeps Telegram bot online. Teachers generate lessons from their phone.
 - **Subject-specific skills.** 13 built-in subject skills (Math, Science, History, ELA, Music, Art, PE, CS, Foreign Language, Library, Special Ed, and more) tune the generation for each discipline's pedagogy.
 
 ---
@@ -300,7 +309,7 @@ Claw-ED is built by a teacher for teachers. Join the conversation:
 - **[Report issues](https://github.com/SirhanMacx/Claw-ED/issues)** — bugs, feature requests, quality feedback
 - **[Star the repo](https://github.com/SirhanMacx/Claw-ED)** — it helps other teachers find us
 
-14,000+ installs and growing. If Claw-ED saved you prep time, tell a colleague.
+14,000+ installs and growing. The agentic layer for education starts here.
 
 ---
 
@@ -308,6 +317,6 @@ Claw-ED is built by a teacher for teachers. Join the conversation:
 
 MIT License. Free for personal and commercial use.
 
-Built by educators, for educators.
+Built by educators, for educators. The agentic layer for education.
 
-[GitHub](https://github.com/SirhanMacx/Claw-ED) | [PyPI](https://pypi.org/project/clawed/) | [Discussions](https://github.com/SirhanMacx/Claw-ED/discussions) | [Changelog](CHANGELOG.md)
+[GitHub](https://github.com/SirhanMacx/Claw-ED) | [PyPI](https://pypi.org/project/clawed/) | [Game Gallery](https://sirhanmacx.github.io/Claw-ED/games) | [Discussions](https://github.com/SirhanMacx/Claw-ED/discussions) | [Changelog](CHANGELOG.md)

{clawed-2.5.3 → clawed-3.0.0}/clawed/__init__.py

@@ -17,9 +17,9 @@ if hasattr(sys.stderr, "reconfigure"):
     except Exception:
         pass
 
-__version__ = "2.5.3"
+__version__ = "3.0.0"
 __author__ = "Jon Maccarello & Claw-ED contributors"
-__description__ = "Personal AI teaching agent. Learns your voice, works while you sleep."
+__description__ = "Your AI co-teacher. Generate lessons, games, slides, and assessments from your terminal."
 
 # Central I/O — re-exported for convenience
 from clawed.io import output_dir as output_dir  # noqa: F401

{clawed-2.5.3 → clawed-3.0.0}/clawed/__main__.py

@@ -10,8 +10,8 @@ def main():
         if hasattr(sys.stderr, "reconfigure"):
             sys.stderr.reconfigure(encoding="utf-8", errors="replace")
 
-        from clawed.cli import app
-        app()
+        from clawed._entry_router import main as entry_main
+        entry_main()
     except KeyboardInterrupt:
         sys.exit(130)
     except SystemExit:

clawed-3.0.0/clawed/_entry_router.py

@@ -0,0 +1,160 @@
+"""Claw-ED v3 entry point router.
+
+Routes to the TypeScript Ink TUI (if Node.js available) or falls back
+to the Python typer CLI. The teacher never needs to know about this
+routing — they just run `clawed`.
+
+Usage:
+    clawed                  → Interactive mode (Ink TUI or Python REPL)
+    clawed lesson "Topic"   → Direct command (routes to Python --json if Ink TUI)
+    clawed --python ...     → Force Python CLI (skip Node.js check)
+    clawed daemon start     → Start background Telegram daemon
+"""
+from __future__ import annotations
+
+import os
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+
+def _find_bundled_cli_js() -> str | None:
+    """Find the pre-built cli.js bundled in the package."""
+    # Check package data directory
+    pkg_dir = Path(__file__).parent
+    cli_js = pkg_dir / "_cli_bundle" / "cli.js"
+    if cli_js.exists():
+        return str(cli_js)
+
+    # Check if we're in a dev environment with the cli/ directory
+    repo_root = pkg_dir.parent
+    dev_cli = repo_root / "cli" / "source" / "cli.js"
+    if dev_cli.exists():
+        return str(dev_cli)
+
+    return None
+
+
+def _find_daemon_entry() -> str | None:
+    """Find the daemon entry point."""
+    pkg_dir = Path(__file__).parent
+    repo_root = pkg_dir.parent
+
+    # Dev environment
+    daemon_ts = repo_root / "daemon" / "index.ts"
+    daemon_js = repo_root / "daemon" / "dist" / "index.js"
+
+    if daemon_js.exists():
+        return str(daemon_js)
+    if daemon_ts.exists():
+        # Use ts-node or tsx for dev mode
+        return str(daemon_ts)
+
+    # Bundled daemon
+    bundled = pkg_dir / "_cli_bundle" / "daemon.js"
+    if bundled.exists():
+        return str(bundled)
+
+    return None
+
+
+def _show_node_notice() -> None:
+    """One-time notice when Node.js is not installed."""
+    notice_file = Path.home() / ".eduagent" / ".node_notice_shown"
+    if notice_file.exists():
+        return
+
+    print(
+        "\n"
+        "  Claw-ED v3.0 — running in classic mode (Python CLI)\n"
+        "\n"
+        "  For the full interactive AI assistant experience,\n"
+        "  install Node.js 18+: https://nodejs.org\n"
+        "\n"
+        "  Classic mode supports all commands:\n"
+        "    clawed lesson \"Topic\" -g 8 -s \"US History\"\n"
+        "    clawed game create \"Topic\"\n"
+        "    clawed ingest ~/Documents/\n"
+        "\n"
+    )
+
+    try:
+        notice_file.parent.mkdir(parents=True, exist_ok=True)
+        notice_file.touch()
+    except OSError:
+        pass  # Non-critical: notice may show again next time
+
+
+def _handle_daemon(args: list[str]) -> None:
+    """Route daemon commands to the Node.js daemon process."""
+    node = shutil.which("node")
+    daemon_entry = _find_daemon_entry()
+
+    if not node:
+        print("The Telegram daemon requires Node.js 18+.")
+        print("Install from: https://nodejs.org")
+        sys.exit(1)
+
+    if not daemon_entry:
+        print("Daemon entry point not found. Reinstall clawed or check your installation.")
+        sys.exit(1)
+
+    # Check if it's a .ts file (dev mode) — use tsx or ts-node
+    if daemon_entry.endswith(".ts"):
+        tsx = shutil.which("tsx")
+        if tsx:
+            result = subprocess.run([tsx, daemon_entry] + args)
+        else:
+            result = subprocess.run([node, "--loader", "ts-node/esm", daemon_entry] + args)
+    else:
+        result = subprocess.run([node, daemon_entry] + args)
+
+    sys.exit(result.returncode)
+
+
+def main() -> None:
+    """Entry point for the `clawed` command.
+
+    Priority:
+    1. daemon commands → Node.js daemon
+    2. --python flag → force Python CLI
+    3. Node.js available + cli.js found → Ink TUI
+    4. Fallback → Python typer CLI
+    """
+    args = sys.argv[1:]
+
+    # Route daemon commands to the Node.js daemon
+    if args and args[0] == "daemon":
+        _handle_daemon(args[1:])
+        return
+
+    # Allow forcing Python CLI
+    if "--python" in args:
+        args.remove("--python")
+        sys.argv = [sys.argv[0]] + args
+        _run_python_cli()
+        return
+
+    # Try Node.js + bundled CLI for interactive/direct commands
+    node = shutil.which("node")
+    cli_js = _find_bundled_cli_js()
+
+    if node and cli_js:
+        result = subprocess.run([node, cli_js] + args)
+        sys.exit(result.returncode)
+    else:
+        if not args:
+            # Interactive mode without Node.js — show notice
+            _show_node_notice()
+        _run_python_cli()
+
+
+def _run_python_cli() -> None:
+    """Run the Python typer CLI (fallback or forced mode)."""
+    from clawed.cli import app
+    app()
+
+
+if __name__ == "__main__":
+    main()

clawed-3.0.0/clawed/_json_output.py

@@ -0,0 +1,63 @@
+"""Structured JSON output for CLI commands.
+
+Every command that supports --json uses this module to produce
+a standard envelope: {status, command, data, files, warnings, errors}.
+"""
+from __future__ import annotations
+
+import json
+import sys
+import traceback
+from typing import Any
+
+
+def json_envelope(
+    command: str,
+    *,
+    status: str = "success",
+    data: Any = None,
+    files: list[str] | None = None,
+    warnings: list[str] | None = None,
+    errors: list[str] | None = None,
+) -> dict[str, Any]:
+    """Build a standard JSON envelope."""
+    return {
+        "status": status,
+        "command": command,
+        "data": data,
+        "files": files or [],
+        "warnings": warnings or [],
+        "errors": errors or [],
+    }
+
+
+def emit_json(envelope: dict[str, Any]) -> None:
+    """Write JSON envelope to stdout and flush."""
+    json.dump(envelope, sys.stdout, default=str)
+    sys.stdout.write("\n")
+    sys.stdout.flush()
+
+
+def run_json_command(command: str, fn, **kwargs) -> None:
+    """Run a function and emit its result as JSON.
+
+    fn must return a dict with optional keys: data, files, warnings.
+    On exception, emits error envelope.
+    """
+    try:
+        result = fn(**kwargs)
+        if result is None:
+            result = {}
+        envelope = json_envelope(
+            command,
+            data=result.get("data"),
+            files=result.get("files", []),
+            warnings=result.get("warnings", []),
+        )
+    except Exception as e:
+        envelope = json_envelope(
+            command,
+            status="error",
+            errors=[str(e), traceback.format_exc()],
+        )
+    emit_json(envelope)

{clawed-2.5.3 → clawed-3.0.0}/clawed/commands/config_llm.py

@@ -7,6 +7,7 @@ from typing import Optional
 import typer
 from rich.panel import Panel
 
+from clawed._json_output import run_json_command
 from clawed.commands._helpers import console
 from clawed.commands.config import config_app
 from clawed.models import AppConfig, LLMProvider
@@ -142,9 +143,24 @@ def config_set_search_key(
     console.print(f"[green]\u2713 {provider.title()} search key saved.[/green]")
 
 
+def _config_show_json():
+    """Return config data for JSON output."""
+    cfg = AppConfig.load()
+    return {
+        "data": cfg.model_dump() if hasattr(cfg, "model_dump") else cfg.dict(),
+        "files": [],
+    }
+
+
 @config_app.command("show")
-def config_show():
+def config_show(
+    json_output: bool = typer.Option(False, "--json", help="Output as JSON"),
+):
     """Show current configuration."""
+    if json_output:
+        run_json_command("config.show", _config_show_json)
+        return
+
     from clawed.config import get_api_key
 
     cfg = AppConfig.load()

{clawed-2.5.3 → clawed-3.0.0}/clawed/commands/config_profile.py

@@ -8,6 +8,7 @@ import typer
 from rich.panel import Panel
 from rich.table import Table
 
+from clawed._json_output import run_json_command
 from clawed.commands._helpers import console, load_persona_or_exit
 from clawed.commands.config import (
     class_app,
@@ -22,8 +23,20 @@ from clawed.commands.config import (
 
 
 @persona_app.command("show")
-def persona_show():
+def persona_show(
+    json_output: bool = typer.Option(False, "--json", help="Output as JSON"),
+):
     """Display the current teacher persona."""
+    if json_output:
+        def _persona_show_json():
+            persona = load_persona_or_exit()
+            return {
+                "data": {"persona": persona.model_dump() if hasattr(persona, "model_dump") else persona.dict()},
+                "files": [],
+            }
+        run_json_command("config.persona.show", _persona_show_json)
+        return
+
     persona = load_persona_or_exit()
     console.print(
         Panel(persona.to_prompt_context(), title="Teacher Persona")
@@ -41,8 +54,25 @@ def standards_list(
     subject: str = typer.Option(
         ..., "--subject", "-s", help="Subject (math, ela, science, history)"
     ),
+    json_output: bool = typer.Option(False, "--json", help="Output as JSON"),
 ):
     """List education standards for a grade and subject."""
+    if json_output:
+        def _standards_json():
+            from clawed.standards import get_standards as _get_stds
+            results = _get_stds(subject, grade)
+            return {
+                "data": {
+                    "standards": [
+                        {"code": s.code, "description": s.description, "band": getattr(s, "band", "")}
+                        for s in results
+                    ] if results else []
+                },
+                "files": [],
+            }
+        run_json_command("config.standards.list", _standards_json)
+        return
+
     from clawed.standards import get_standards, resolve_subject
 
     canonical = resolve_subject(subject)

{clawed-2.5.3 → clawed-3.0.0}/clawed/commands/export.py

@@ -15,6 +15,7 @@ import typer
 from rich.panel import Panel
 from rich.table import Table
 
+from clawed._json_output import run_json_command
 from clawed.commands._helpers import console
 from clawed.database import Database
 
@@ -305,8 +306,23 @@ def export_cmd(
         "-f",
         help="Export format: classroom",
     ),
+    json_output: bool = typer.Option(False, "--json", help="Output as JSON"),
 ):
     """Export a lesson plan (e.g., to Google Classroom JSON)."""
+    if json_output:
+        def _export_json():
+            p = Path(lesson_file).expanduser().resolve()
+            if not p.exists():
+                raise FileNotFoundError(f"File not found: {p}")
+            data = json.loads(p.read_text(encoding="utf-8"))
+            out_path = p.with_suffix(".classroom.json")
+            return {
+                "data": {"title": data.get("title", ""), "format": fmt},
+                "files": [str(out_path)] if out_path.exists() else [],
+            }
+        run_json_command("export", _export_json)
+        return
+
     path = Path(lesson_file).expanduser().resolve()
     if not path.exists():
         console.print(f"[red]File not found:[/red] {path}")