export-cards

Skill: Export Cards

Instructions

Step 1: Gather inputs

• [ ] Confirm the vault path.
• [ ] Confirm the output file path. Default to cards.json in the current working directory if the user does not specify.

Step 2: Run the CLI

• [ ] Execute: estudeme cards export <vault-path> --output <output-file>
• [ ] Capture exit code and any messages.

Step 3: Confirm

• [ ] On success: report the output file path and the count of cards exported.
• [ ] Suggest the user verify the file (e.g., wc -l <output> or open it).

Critical

• The export writes a new file outside the vault — it does not modify the vault.
• If the output file already exists, the CLI overwrites it. Warn the user before running if they did not explicitly ask for overwrite.

Examples

Example 1: Default location

User says: "Export my cards from ~/study/my-vault."

Actions:

• Confirm the output path with the user: "Save as cards.json here?"
• Run estudeme cards export ~/study/my-vault --output cards.json
• Report the file path and card count

Result: A JSON file ready for Anki import or downstream tooling.

Troubleshooting

Error: Permission denied: cannot write to <path>

• Cause: the output directory is not writable.
• Solution: ask the user for an alternate path.

Error: No cards to export

• Cause: vault has no type: card documents.
• Solution: nothing to export — confirm with the user that they expected cards.

Performance Notes

• The export is fast for typical vaults (< 1000 cards). No batching needed.