Local Tasks

Keep personal or exploratory issues on your machine without committing them—then promote them to the shared project when they're ready.

Your Private Scratchpad

Keep exploratory work separate until it's ready to share.

Sometimes you need to jot down ideas, explore a wild hypothesis, or track personal reminders without cluttering the team's shared board. Local tasks give you a private workspace that lives right alongside your shared project—visible to you, invisible to version control.

When you create a local task, Kanbus stores it in a special directory that never gets committed. Your teammates won't see your half-baked experiments or personal notes, but you'll still see everything together in your own view. It's like having a private notebook that sits next to the team's whiteboard.

Seamless Promotion

Move from private to shared with a single command.

The magic happens when your experiment turns into something real. With one command, you can promote a local task to the shared project. All your notes, history, and context move with it—no copying, no manual file moves, no risk of losing anything. What was private becomes public instantly, ready for your team to see and collaborate on.

You can also go the other way. If a shared task needs to become a private exploration—maybe you're taking it off the public board temporarily or doing a speculative rewrite—you can localize it just as easily. The task disappears from version control but stays in your workspace.

Clean Team Views

See everything together, or filter to what matters.

By default, Kanbus shows you both shared and local tasks together. You get the full picture of everything you're working on, whether it's committed to the repo or just living on your machine. But when you need to focus—or when you're sharing a task list with a teammate—you can filter to show only shared work, hiding your private scratchpad entirely.

Or flip it around: view only your local tasks to see your personal backlog at a glance. It's your workspace, and you control what you see.

Automatic Privacy

Kanbus handles the details so you don't have to.

The first time you create a local task, Kanbus sets everything up automatically. It creates the right directory structure and updates your gitignore file to ensure your private work stays private. You don't need to remember any special configuration or worry about accidentally committing personal notes—Kanbus takes care of it.

This works whether you're using Kanbus's native storage or working with Beads-backed projects. The same simple workflow applies everywhere, so you can focus on your work instead of managing file locations.

Learn More

Ready to start using local tasks?

Local tasks help you keep your workspace organized while maintaining a clean, focused view for your team. Whether you're exploring new ideas, tracking personal reminders, or temporarily pulling work off the shared board, local tasks give you the flexibility to work the way you want.

Read the Documentation →