Keep your AI focused. Stay organized. Ship faster.
ADbS helps you work with AI coding assistants (Cursor, Windsurf, Zed, and more) by keeping them focused on your goals and preventing hallucinations.
One command to rule them all. Detects your OS and IDE automatically.
curl -sSL https://raw.githubusercontent.com/oyi77/ADbS/main/install.sh | bash# Initialize ADbS in your project
adbs setup
# Start working on something
adbs new "user authentication"
# Check what you're working on
adbs status
# Add a reminder
adbs todo "Write tests for login"
# Mark work as complete
adbs done "user authentication"That's it! No configuration needed.
When working with AI coding assistants, you've probably experienced:
- 🤯 AI forgetting what you asked it to do
- 🔄 AI going in circles or hallucinating solutions
- 📝 Losing track of what needs to be done
- 🎯 Difficulty keeping AI focused on the goal
ADbS solves this by:
- ✅ Keeping AI focused with structured work items
- ✅ Organizing your work automatically
- ✅ Preventing AI hallucinations with clear context
- ✅ Working seamlessly with your IDE
adbs new <name> # Start new feature or fix
adbs status # Show current work
adbs done <name> # Mark work as complete
adbs show <name> # Show work detailsadbs todo <description> # Add a task or reminder
adbs list # List all work and tasks
adbs update <id> <field> # Update a taskadbs setup # Initialize ADbS
adbs check # Validate current work
adbs version # Show version
adbs help # Show help- Start Work:
adbs new "feature name"creates a structured work item - AI Reads Context: Your AI assistant automatically sees what you're working on
- Stay Focused: AI stays on track with clear goals and context
- Track Progress: Use
adbs statusto see what's active - Complete:
adbs done "feature name"archives the work
ADbS works with:
- Cursor: Auto-generates
.cursor/rules - Windsurf: Native Cascade support
- Zed: Project-specific rules
- VS Code: Full integration
- Other AI IDEs: Universal support
Rules are generated automatically when you run adbs setup.
- User Guide: Detailed usage instructions
- Reference: Complete command reference
- Architecture: Technical deep dive (for developers)
- Contributing: How to contribute
# Start a new feature
$ adbs new "add payment processing"
✓ Started new work: add payment processing
Next steps:
1. Edit the work plan: .adbs/work/2025-12-30-add-payment-processing/proposal.md
2. Check status: adbs status
3. Mark done: adbs done "add payment processing"
# Add some tasks
$ adbs todo "Research payment providers"
✓ Added task: Research payment providers
$ adbs todo "Implement Stripe integration"
✓ Added task: Implement Stripe integration
# Check status
$ adbs status
ADbS Status
===========
Active work: 1
Completed: 0
Active Work:
• add payment processing
# Work on it with your AI assistant...
# AI stays focused on the payment processing feature
# Mark as done
$ adbs done "add payment processing"
✓ Completed: add payment processing
Archived to: .adbs/archive/2025-12-30-add-payment-processingWe welcome contributions! Please see our Contributing Guide.
MIT
Made with ❤️ for developers working with AI assistants