Core Management

Manage your project management issues right from your terminal.

←Back to Core Management feature page

Kanbus provides a fully-featured CLI for managing your issues, epics, and tasks. Because everything is stored as JSON files, your issues are always right alongside your code, meaning you can easily update them using straightforward terminal commands.

Creating Issues

You can create issues quickly and define relationships (like assigning an issue to an epic) from the command line:

Terminal
# Create a top-level bug issue with high priority
kanbus create "Fix login race condition" --type bug --priority high

# Create a task underneath an existing epic/parent
kanbus create "Implement backend API" --parent kanbus-a1b2c3

Listing and Filtering

You can list issues, which is especially powerful when using filters. Kanbus can show just the issues assigned to you, specific issue types, or issues in a certain status.

Terminal
# List high-priority bugs assigned to you
kanbus list --type bug --priority high --assignee @me

# Show only open (non-final state) issues
kanbus list --status open

# Output as JSON for machine parsing or scripting
kanbus list --json

Updating the Workflow

When you're ready to start working on an issue, you can use the Kanbus CLI to update its status or assignee, moving it smoothly through your project's workflow.

Terminal
# Automatically move to an "in_progress" state and assign to yourself
kanbus start kanbus-x9y8z7

# Manually update specific fields
kanbus update kanbus-x9y8z7 --status in_progress --assignee "you@example.com"

# Close an issue and optionally leave a comment
kanbus close kanbus-x9y8z7 --comment "Fixed via PR #42"