PufferFlow 🐡

Beta Release - Fresh from the Deep! 🌊

Turn your tasks.md into a sea of possibilities with one-click execution.

PufferFlow is a whimsical VS Code extension that adds magical "Start Task" and "Retry" buttons above your markdown task items. Inspired by Kiro's workflow philosophy, PufferFlow transforms your to-do lists into executable workflows with zero friction - just like Kiro would handle tasks, but with our friendly pufferfish guide!

🚧 Beta Notice: PufferFlow is fresh from the development depths! While our pufferfish is eager to help, you might encounter some rough waters. The code is still getting optimized and bugs are being squashed daily. Dive in with a spirit of adventure! 🐡

🐡 What Makes PufferFlow Special?

Kiro-Inspired Workflow

• Think Like Kiro: Direct task execution without context switching
• Intelligent Automation: Tasks are handled the way Kiro would approach them
• Context-Aware Execution: Includes steering files and project context, Kiro-style
• Effortless Flow: From planning to execution in one click, just as Kiro intended

Instant Task Activation

• Puff & Go: Click "Start Task" and watch the magic happen
• Second Chances: "Retry" buttons for when tasks need another swim
• Smart Detection: Automatically spots - [ ] and - [x] tasks in your tasks.md
• Agent-Powered: Works beautifully with VS Code's agent mode (GitHub Copilot recommended)

Zero-Friction Workflow

• No context switching required
• Direct execution from markdown files
• Automatic task completion marking (- [ ] → - [x])
• Seamless integration with your existing workflow

🌊 How It Works (The Kiro Way)

PufferFlow follows Kiro's approach to task execution - intelligent, context-aware, and effortless:

1. Open your tasks.md - PufferFlow automatically detects your tasks
2. Click the shiny buttons - CodeLens buttons appear above each task
3. Watch the Kiro-inspired magic - Your task gets sent to the agent with steering file context
4. Automatic completion - Tasks puff up to completed state when done, just like Kiro would mark them!

Example in Action

# My Underwater Project 🐠

- [ ] Set up the coral reef structure
- [ ] Implement the fish authentication system  
- [ ] Create the seaweed database migrations
- [x] Write comprehensive bubble tests
- [ ] Deploy to the deep sea environment

Each uncompleted task gets a friendly "🐡 Start Task" button, while completed ones show "🔄 Retry" buttons!

🚀 Installation

1. Open VS Code Extensions (Ctrl+Shift+X)
2. Search for "PufferFlow"
3. Click Install
4. Open any tasks.md file and watch the pufferfish magic begin!

Beta Disclaimer: Expect some splashing as we refine the experience!

🎯 Perfect For

• Kiro-Style Workflow: Execute tasks the intelligent, automated way
• Project Planning: Turn your ideas into action
• Development Workflows: Automate your coding tasks with context
• Documentation: Make your docs executable
• Team Collaboration: Share actionable task lists
• Learning: Practice with guided, contextual assistance
• Beta Testing: Help us make PufferFlow even better!

🛠️ Technical Details

PufferFlow uses VS Code's CodeLens API to create lightweight, non-intrusive buttons above your task items. Following Kiro's methodology, when clicked, tasks are sent to your configured agent along with steering file context for intelligent execution.

Requirements

• VS Code 1.74.0 or higher
• Agent mode enabled (GitHub Copilot or compatible)
• A sense of whimsy 🐡
• Patience for beta quirks 😊

Under the Hood

• CodeLens Integration: Lightweight UI that doesn't interfere with your editing
• Markdown Parser: Intelligently detects task patterns
• Kiro-Inspired Agent Communication: Constructs context-aware prompts with steering files
• State Management: Automatically toggles task completion states

Note: The code is still swimming through optimization waters - performance improvements and bug fixes are ongoing!

🎨 Why PufferFlow?

Because your tasks deserve more than just sitting there looking sad! Inspired by Kiro's efficient approach to task management, PufferFlow brings personality and power to your productivity workflow. Like a pufferfish that transforms when needed, your static task lists become dynamic, executable workflows - exactly the way Kiro would want them!

Features that make you smile:

• 🐡 Whimsical button text and interactions
• 🌊 Smooth, bubble-like execution flow
• 🎯 Intelligent context inclusion from steering files (Kiro-style)
• 🔄 Effortless retry capabilities
• 📝 Automatic progress tracking

🐛 Known Beta Limitations

• Code optimization is ongoing
• Some edge cases may cause unexpected behavior
• Performance improvements are in progress
• Error handling is being refined

🤝 Contributing

Want to help make PufferFlow even more magical? We welcome contributions! The codebase is designed to be as friendly as our pufferfish mascot, though it's still getting its fins organized.

Beta Contributors Welcome!

• Bug reports and feedback
• Code optimizations
• Feature suggestions
• Testing across different setups

📄 License

MIT License - As free as fish in the sea!

🗺️ Roadmap

• Immediate: Code optimization and bug fixes
• Enhanced task templating (different fish for different tasks?)
• Team collaboration features
• Custom agent integration options
• More aquatic-themed delights
• Performance optimizations

Ready to dive into effortless task execution? Install PufferFlow and let your tasks swim to completion the Kiro way! 🐡✨

PufferFlow Beta: Where Kiro's productivity philosophy meets personality in the vast ocean of VS Code extensions. Expect some waves as we navigate to version 1.0!