A CLI tool for managing Obsidian vault documents and generating flashcards with AI.

• 🎴 Interactive Flashcard Generation: Generate flashcards from markdown documents using AI
• 🎯 Smart Selection: Visual interface to select which flashcards to keep
• 📝 Live Preview: See exactly what changes will be made before applying them
• ✅ Document Management: Mark documents as complete after processing
• ⚡ Fast: Built with Bun for optimal performance

# Install dependencies
bun install

# Compile and install globally
bun run install-global

After installation, you can use obsidian-manager from anywhere in your terminal.

# Install dependencies
bun install

# Run directly with bun
bun index.ts [command] [options]

# Or compile first
bun run compile
./dist/index.js [command] [options]

# Interactive flashcard generation
obsidian-manager generate-flashcard path/to/document.md

# Or use the short alias
obsidian-manager gfc path/to/document.md

This command will:

1. 📖 Read your markdown document
2. 🤖 Generate new flashcards using AI
3. 📋 Show both new and existing flashcards
4. 🎯 Let you select which ones to keep
5. 📝 Preview changes before applying
6. ✅ Optionally mark the document as complete

# Placeholder for future functionality
obsidian-manager path/to/document.md

When using generate-flashcard, you'll see an interactive interface:

• ↑↓: Navigate between flashcards
• Space: Toggle flashcard selection
• M: Toggle "mark document as complete"
• Enter: Proceed to diff preview
• Y/N: Confirm or cancel actions
• Q: Quit at any time

Make sure you have your AWS credentials set up for the AI flashcard generation:

export AWS_ACCESS_KEY_ID=your_access_key
export AWS_SECRET_ACCESS_KEY=your_secret_key

• bun run build - Build the CLI
• bun run compile - Build and make executable
• bun run install-global - Compile and install globally
• bun run uninstall - Remove global installation
• bun run dev - Run in development mode with hot reload

To remove the global installation:

bun run uninstall

# Install dependencies
bun install

# Run in development mode
bun run dev

# Run tests
bun test

src/
├── cli.ts              # Main CLI command logic
├── flashcard-cli.tsx   # Interactive UI components
├── document-parser.ts  # Markdown document parsing
├── document-updater.ts # Document writing utilities
├── flashcard.ts        # AI flashcard generation
├── bedrock.ts         # AWS Bedrock configuration
└── types.ts           # TypeScript type definitions