first commit

README.md

@@ -0,0 +1,30 @@
+# clawd_code
+
+`clawd_code` is now being migrated as a pure Dart CLI, not a Flutter app.
+
+The legacy source lives in `old_repo/` and currently contains the TypeScript/Bun
+implementation that this package is replacing. The Dart side now provides:
+
+- a real CLI executable in `bin/clawd_code.dart`
+- a command model and legacy command inventory
+- a REPL shell with 24 migrated legacy commands
+- persisted local settings, auth metadata, permissions, and usage stats
+- migration-aware status/help output so legacy entrypoints do not disappear
+
+## Run
+
+```bash
+dart run bin/clawd_code.dart
+dart run bin/clawd_code.dart --help
+dart run bin/clawd_code.dart --version
+```
+
+## Current Status
+
+The top-level CLI contract is being rebuilt in Dart first, with the remaining
+command implementations and runtime subsystems still being ported incrementally
+from `old_repo/`.
+
+The existing Flutter platform folders are still present in the workspace as
+leftovers from the starter template, but the package configuration is now
+Dart-only.