import-posts

Run the import command with the --file flag pointing to your JSON file, for example --file /path/to/posts.json. The tool previews the posts, validates the structure, and asks for confirmation before merging them into your feed.

The file must be valid JSON containing posts with the required fields post_id, persona_id, and content. Files missing these fields or with malformed JSON fail validation before any data is imported.

The import detects personas not in your registry and prompts you to either skip those posts or automatically create placeholder personas. You can also cancel the import entirely at that point.

No, the validation step checks for duplicate post_ids against your existing posts and skips them. The confirmation summary reports how many posts were imported versus skipped as duplicates.

Yes, pass the --replace flag to overwrite all existing posts with the imported content. The default behavior without flags is --merge, which adds new posts alongside existing ones.