Smaug Files

What's New

💰 Token Usage Tracking

Track your Claude API costs with the new -t flag:

:::bash
npx smaug run -t

Displays a detailed breakdown at the end of each run showing input/output tokens, cache usage, and estimated costs by model.

📁 Bookmark Folder Support

Preserve your Twitter bookmark folder organization! Configure folder IDs mapped to tag names:

:::json
{
  "folders": {
    "1234567890": "ai-tools",
    "0987654321": "articles-to-read"
  }
}

Bookmarks now include folder tags in both bookmarks.md entries and knowledge file frontmatter.

⚡ Configurable Parallel Processing

New parallelThreshold config option (default: 8) controls when parallel subagent processing kicks in. Small batches now process sequentially for faster results:

:::json
{
  "parallelThreshold": 8
}

🎯 Batch Limiting

Process bookmarks in controlled batches with the new --limit flag:

:::bash
npx smaug run --limit 50 -t    # Process 50 at a time with cost tracking

🐛 Bug Fixes

• Fixed nested Claude invocation - Resolved hanging issues when Claude spawns subprocesses
• Fixed stdin handling - Changed from inherit to pipe to prevent blocking
• Fixed bird CLI pipe buffering - JSON output now captured correctly on all systems
• Fixed tilde expansion - Home directory paths now work reliably across platforms

🌍 Cross-Platform Improvements

• Replaced jq and sed shell commands with Node.js equivalents
• No additional system dependencies beyond Node.js
• Works on Windows (with Node.js), macOS, and Linux

🧪 Developer Experience

• Added comprehensive test suite
• CI workflow for automated testing
• Improved error messages and logging

Upgrading

:::bash
git pull
npm install

No breaking changes from v0.2.x.

Full Changelog

https://github.com/alexknowshtml/smaug/compare/v0.2...v0.3.0