🦁 BeTheTamer

Professional Kanban for Developers. Zero Context Switching.

Manage tasks, track progress, and coordinate AI agents directly from your code comments. No external tools, no context switching, just pure flow.

⚡ Why BeTheTamer?

Traditional project management tools (Jira, Trello) live outside your IDE, causing friction. BeTheTamer brings the project management into your codebase.

• Stay in Flow: Create/update tickets without leaving the file you're editing.
• AI-Native: Built to give context to Cursor, Windsurf, and Copilot instantly.
• Zero Overhead: A simple comment is all it takes.

⚡ Quick Start: Import Existing TODOs

Already have comments in your code? BeTheTamer can scan your specific project for // TODO: and // FIXME: comments and convert them into tickets instantly.

1. Open Command Palette (Cmd+Shift+P).
2. Run BeTheTamer: Import TODOs.
3. Select the items you want to track.
4. 🚀 Done! They are now on your Kanban board.

🚀 Interactive CLI

Initialize your project in seconds with our new interactive CLI.

# Start the interactive setup wizard
bethetamer init

The wizard will guide you to:

1. Generate Agent Rules: Auto-detects your IDE (Cursor, Windsurf, VS Code, Antigravity) and creates the perfect system prompt.
2. Create Ignore File: Sets up .bethetamerignore to keep your board clean.
3. Scaffold Demo: Creates a sample project to test the workflow.

Manual Commands:

# Check for duplicate IDs or invalid statuses
bethetamer check

# Export your board to HTML/Markdown
bethetamer export-board --format html

📝 Syntax Guide

Standard Ticket

Use @ticket for tasks, bugs, or improvements.

// @ticket Implement user authentication
//   @id: T0aa2
//   @epic-ref: User Accounts System
//   // (You can also use the Epic ID, e.g. @epic-ref: E101)
//   @status: todo
//   @priority: high
//   @tags: backend, security
// @end

Epic (New!)

Use @epic to define high-level features or goals.

// @epic User Accounts System
//   @id: E101
//   @status: todo
//   @description: Handles all user registration and profile management.
// @end

Supported Fields

🤖 AI Superpowers

BeTheTamer isn't just a Kanban board; it's a context engine for AI.

Smart Context Switching

Stop wasting tokens re-explaining your project.

1. Tag it: Add // @checkpoint: Reached working MVP
2. Export it: Run "BeTheTamer: Export Context"
3. Feed it: Paste the minified JSON into a fresh chat. Your AI now knows the exact state of every task.

Token Savings

💰 How to Save Tokens (Best Practice)

1. Init & Forget: Configure your rules once with bethetamer init.
2. Plan First: Create your tickets and epics (/start-epic) before asking the AI to write code.
3. Context-First: Instead of adding your whole codebase to the chat:
   • Run BeTheTamer: Generate Context Map.
   • Copy the output.
   • Paste it into your Agent (Cursor/Windsurf).
   • Result: The agent knows your entire architecture and task list for the cost of a few kilobytes. | Large (100+ Files) | ~150k+ tokens | ~30k tokens | 📉 ~80% |

🎨 Visual Boards

Visualize your progress with stunning, built-in Kanban boards.

• Generative Themes: Choose from "Deep Slate" (Professional), "Gradient" (Vibrant), or "Light/Dark".
• Drag & Drop: (Coming Soon) Update status by dragging cards.
• Exportable: Share progress with stakeholders via standalone HTML files.

📦 Installation

1. Install Extension: Search "BeTheTamer" in VS Code Marketplace.
2. Install CLI: npm install -g bethetamer (Optional, for CI/CD).
3. Init: Run bethetamer init in your project root.

📄 License

Proprietary / Commercial

• Free Trial: Full access for 3 days.
• Pro License: Required for ongoing access to AI features and advanced exports.

Made with ❤️ for developers who love to stay in the zone.