Sync prompts to your machine

The sync subcommand pulls individual prompts (not packs) onto your machine as plain markdown files. Useful when you want a single tool, not a whole role kit.

Why sync

You can grep them offline.
They go into version control with the rest of your project.
They render natively in any markdown previewer.

Sync everything

bash

noddle-deck sync all

By default this writes to ~/.noddle-deck/prompts/<category>/<id>.md. Override with --out:

bash

noddle-deck sync all --out ./prompts

Sync one category

bash

noddle-deck sync category writing
noddle-deck sync category technology --out ./team/prompts

Run noddle-deck list categories first if you don't know the slug.

Output format

Each prompt becomes a markdown file with YAML frontmatter:

markdown

---
id: meeting-summary-v2
name: Meeting Summary
description: Summarize a meeting transcript into action items
ai_models: [chatgpt, claude]
variables: [transcript]
---

# Meeting Summary

Summarize the following meeting transcript into:
1. Three-bullet TL;DR
2. Decisions made
3. Action items with owners

Transcript:
{{transcript}}

You can paste the body directly into any LLM chat after filling {{transcript}}.