kanban-tui

🥈Silver

Kanban-TUI is a Python-based task manager with a terminal user interface (TUI) for agents. It enables operations teams to manage tasks efficiently, integrating with Jira for workflow management. The tool connects to Python-based workflows and supports Claude agents.

22760Updated 4d ago

Intermediate30min to implementautomation

Saves ~150 min per use

Quick InstallView Source

git clone https://github.com/Zaloog/kanban-tui.git

Works with:

Claude

Overview

About This Skill

How to Use

["Install the Kanban-TUI tool using `pip install kanban-tui` and ensure it's added to your Python environment path.","Initialize a new board for your project with `kanban-tui --init [PROJECT_NAME] --team [TEAM_NAME]`. Customize the default columns if needed.","Add tasks to the board using `kanban-tui --add \"[TASK_DESCRIPTION]\" --priority [HIGH/MEDIUM/LOW] --assignee [NAME]`. Use the `--link-jira [JIRA_KEY]` flag to connect tasks to Jira issues.","Update task statuses by navigating with arrow keys and pressing Enter to move tasks between columns. Use the search function (`kanban-tui --search [NAME]`) to filter tasks by assignee.","Export the board state to a JSON file with `kanban-tui --export [FILENAME.json]` for reporting or integration with other tools. Sync changes back to Jira using `kanban-tui --sync-jira`."]

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/Zaloog/kanban-tui

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Use the Kanban-TUI tool to manage and track the progress of [PROJECT_NAME] tasks. Create a new board for [TEAM_NAME] with columns: 'Backlog', 'In Progress', 'Review', 'Done'. Add the following tasks: [LIST_TASKS]. Update the status of tasks as they move through the workflow. Use the search function to find tasks assigned to [ASSIGNEE_NAME].

Example Output

```
Kanban-TUI v1.2.0 - [PROJECT_NAME] Board
┌───────────────────────────────────────────────────────────────────────────────┐
│ Backlog (3)                          │ In Progress (2)                     │
├──────────────────────────────────────┼──────────────────────────────────────┤
│ 1. [HIGH] Implement user authentication│ 4. [MEDIUM] Fix login timeout bug    │
│ 2. [LOW] Design API documentation    │ 5. [HIGH] Resolve database deadlock  │
│ 3. [MEDIUM] Add rate limiting         │                                      │
├──────────────────────────────────────┼──────────────────────────────────────┤
│ Review (1)                           │ Done (4)                            │
├──────────────────────────────────────┼──────────────────────────────────────┤
│ 6. [MEDIUM] Code review for PR #42    │ 7. [LOW] Update README.md             │
│                                      │ 8. [MEDIUM] Merge feature branch     │
│                                      │ 9. [HIGH] Deploy v2.1.0              │
│                                      │ 10. [LOW] Close stale issues          │
└──────────────────────────────────────┴──────────────────────────────────────┘

Search Results for 'john.doe':
- Task 4: Fix login timeout bug (In Progress, Assigned to: john.doe)
- Task 5: Resolve database deadlock (In Progress, Assigned to: jane.smith)

[Status: 10 tasks total | 4 done (40%) | Last updated: 2024-05-20 14:32:15]
```

The Kanban-TUI tool has successfully created a visual representation of the [PROJECT_NAME] workflow. The board shows 10 tasks distributed across four columns, with clear priorities marked by [HIGH]/[MEDIUM]/[LOW] labels. The search function quickly identified tasks assigned to john.doe, highlighting their current status in the 'In Progress' column. The tool also provides a progress percentage (40% complete) and timestamp for last updates, which helps teams track velocity and identify bottlenecks. The interface is keyboard-navigable, allowing agents to update task statuses directly from the terminal without switching tools.