feat(cli): launch TUI by default for bare codeclaw

- route plain codeclaw to TUI when no subcommand is provided
- preserve legacy root export shortcut when export flags are passed
- update docs and add regression tests for default and export-flag dispatch

Author: ychampion

README.md

@@ -146,6 +146,8 @@ codeclaw console --source codex
 Full-screen TUI mode:
 
 ```bash
+codeclaw
+# equivalent explicit command:
 codeclaw tui --source both
 ```
 

codeclaw/cli/__init__.py

@@ -148,6 +148,23 @@ def _handle_finetune(args: argparse.Namespace) -> None:
     handle_finetune(args)
 
 
+def _resolve_default_command(args: argparse.Namespace) -> str:
+    """Resolve the implicit command when no subcommand was provided."""
+    if args.command:
+        return args.command
+    export_intent = bool(
+        args.output
+        or args.repo
+        or args.all_projects
+        or args.no_thinking
+        or args.no_push
+        or args.dry_run
+        or args.publish_attestation
+        or getattr(args, "attest_user_approved_publish", False)
+    )
+    return "export" if export_intent else "tui"
+
+
 def main() -> None:
     COMMAND_HANDLERS = {
         "prep": _handle_prep,
@@ -331,7 +348,7 @@ def main() -> None:
         help="Additional plugin directory (repeatable)",
     )
 
-    exp = sub.add_parser("export", help="Export and push (default)")
+    exp = sub.add_parser("export", help="Export and push datasets")
     # Export flags on both the subcommand and root parser so `codeclaw --no-push` works
     for target in (exp, parser):
         target.add_argument("--output", "-o", type=Path, default=None)
@@ -350,6 +367,6 @@ def main() -> None:
         target.add_argument("--attest-user-approved-publish", action="store_true", help=argparse.SUPPRESS)
 
     args = parser.parse_args()
-    command = args.command or "export"
+    command = _resolve_default_command(args)
     handler = COMMAND_HANDLERS.get(command, _run_export)
     handler(args)

docs/SKILL.md

@@ -91,6 +91,7 @@ codeclaw watch --pause                     # Pause watcher without stopping proc
 codeclaw watch --resume                    # Resume watcher polling
 codeclaw watch --switch-project "project"  # Scope watcher to one connected project
 codeclaw console --source both             # Open interactive slash-command console
+codeclaw                                  # Open full-screen TUI by default
 codeclaw tui --source both                 # Open full-screen TUI mode
 codeclaw update-skill claude               # Install/update the codeclaw skill for Claude Code
 ```

tests/test_new_features.py

@@ -57,6 +57,30 @@ def _fake_tui(_args):
     assert called["tui"] is True
 
 
+def test_main_default_dispatches_tui(monkeypatch):
+    called = {"tui": False}
+
+    def _fake_tui(_args):
+        called["tui"] = True
+
+    monkeypatch.setattr(codeclaw_cli, "handle_tui", _fake_tui)
+    monkeypatch.setattr(sys, "argv", ["codeclaw"])
+    codeclaw_cli.main()
+    assert called["tui"] is True
+
+
+def test_main_root_export_flags_still_dispatch_export(monkeypatch):
+    called = {"export": False}
+
+    def _fake_export(_args):
+        called["export"] = True
+
+    monkeypatch.setattr(codeclaw_cli, "_run_export", _fake_export)
+    monkeypatch.setattr(sys, "argv", ["codeclaw", "--no-push"])
+    codeclaw_cli.main()
+    assert called["export"] is True
+
+
 def test_finetune_requires_experimental(capsys):
     with pytest.raises(SystemExit):
         finetune.handle_finetune(argparse.Namespace(experimental=False, dataset=None, output=None))