tomashrdlicka/twitter-queue

twitter-queue

Show articles marked for sharing on Twitter/X.

Usage

/twitter-queue
/twitter-queue --posted
/twitter-queue --draft "article title"

Options

• --posted - Show previously posted items (marked done)
• --draft <title> - Draft a tweet/thread for a specific article

Instructions

When the user invokes /twitter-queue, follow these steps:

Step 0: Load Configuration

Read config.json from the engram project root to get the vault path:

{
  "vault_path": "~/Documents/Obsidian/WebCapture"
}

Use the vault_path value as {VAULT_PATH} in all paths below. Expand ~ to the user's home directory.

Step 1: Read Index

Read {VAULT_PATH}/_system/index.json

Step 2: Filter Twitter Queue

Filter notes where share_intent == "twitter" (and optionally twitter_posted != true for unposted items).

Step 3: Display Queue

For each note in the queue, display:

## Twitter Queue (X items)

### 1. {title}
**Source:** {url}
**Summary:** {1-2 sentence summary}
**Suggested angle:** {tweet angle based on user_context and key_points - what makes this share-worthy}
**Tags:** {tags formatted as potential hashtags}
**Captured:** {date}

Step 4: Suggest Actions

• "Want me to draft a tweet for any of these?"
• "Mark an item as posted with /twitter-queue --posted"
• If --draft specified, write a compelling tweet or thread based on the article's content, optimized for engagement

Step 5: Mark as Posted

If user asks to mark an item as posted:

1. Update note frontmatter using obsidian-cli:

   obsidian-cli frontmatter "{note-path}" --edit --key "twitter_posted" --value "true"
   obsidian-cli frontmatter "{note-path}" --edit --key "twitter_posted_at" --value "{today ISO date}"
   

2. Update index.json - set twitter_posted: true and twitter_posted_at on the note entry
3. Regenerate views/twitter-queue.md

Notes

• Vault: {VAULT_PATH}/
• Index: _system/index.json
• obsidian-cli frontmatter is used for clean frontmatter updates without parsing YAML manually