commit 7541a5279b42676a8ce22596ccb45866c12e51a5
Author: ImBenji <benjamin.watt@imbenji.net>
Date:   Fri Apr 3 17:43:10 2026 +0100

    first commit

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..61b5205
--- /dev/null
+++ b/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.