Skip to content
Back to search

kanban-tui

Task Manager with a TUI written in Python and usable by agents

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Zaloog/kanban-tui with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Zaloog/kanban-tui'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/zaloog--kanban-tui/badge.svg)](/listings/zaloog--kanban-tui)

HTML

<a href="/listings/zaloog--kanban-tui"><img src="/api/listings/zaloog--kanban-tui/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

You can install `kanban-tui` with one of the following options:

uv tool install kanban-tui
pipx install kanban-tui
# not recommended
pip install kanban-tui

I recommend using [pipx] or [uv] to install CLI Tools into an isolated environment.

To be able to use `kanban-tui` in your browser with the `--web`-flag, the optional dependency `textual-serve` is needed. You can add this to `kanban-tui` by installing the optional `web`-dependency with the installer of your choice, for example with [uv]:

uv tool install 'kanban-tui[web]'

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 276 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <!-- Icons -->
  2. [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
  3. [![PyPI-Server](https://img.shields.io/pypi/v/kanban-tui.svg)](https://pypi.org/project/kanban-tui/)
  4. [![Pyversions](https://img.shields.io/pypi/pyversions/kanban-tui.svg)](https://pypi.python.org/pypi/kanban-tui)
  5. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  6. [![Downloads](https://static.pepy.tech/badge/kanban-tui)](https://pepy.tech/project/kanban-tui)
  7. [![Coverage Status](https://coveralls.io/repos/github/Zaloog/kanban-tui/badge.svg?branch=main)](https://coveralls.io/github/Zaloog/kanban-tui?branch=main)
  8. # kanban-tui
  9. A customizable terminal-based task manager powered by [Textual][textual] with multiple backends.
  10. Now also usable in co-op mode with AI agents (check the [CLI interface](#cli-interface) and [MCP Server](#mcp-server) section for more info).
  11. ## Demo
  12. ![demo_gif](https://raw.githubusercontent.com/Zaloog/kanban-tui/main/docs/demo.gif)
  13. Try `kanban-tui` instantly without installation:
  14. ```bash
  15. uvx kanban-tui demo
  16. ```
  17. ## Features
  18. <details><summary>following the xdg basedir convention</summary>
  19. kanban-tui utilizes [pydantic-settings] and [xdg-base-dirs] `user_config_dir` to save
  20. the config file and `user_data_dir` for the sqlite database.
  21. you can get an overview of all file locations with `uvx kanban-tui info`
  22. </details>
  23. <details><summary>Customizable Board</summary>
  24. kanban-tui comes with four default columns
  25. (`Ready`, `Doing`, `Done`, `Archive`) but can be customized to your needs.
  26. More columns can be created via the `Settings`-Tab. Also the visibility and order of columns can be adjusted.
  27. Deletion of existing columns is only possible, if no task is present in the column you want to delete.
  28. </details>
  29. <details><summary>Multiple Backends</summary>
  30. kanban-tui currently supports three backends.
  31. - **sqlite** (default) | Supports all features of `kanban-tui`
  32. - **jira** | Connect to your jira instance via api key and query tasks via jql.
  33. Columns are defined by task transitions.
  34. - **claude** | Read the `.json` files under `~/.claude/tasks/`. Boards are created for each session ID.
  35. Supports only a subset of features
  36. </details>
  37. <details><summary>Multi Board Support</summary>
  38. With version v0.4.0 kanban-tui allows the creation of multiple boards.
  39. Use `B` on the `Kanban Board`-Tab to get an overview over all Boards including
  40. the amount of columns, tasks and the earliest Due Date.
  41. </details>
  42. <details><summary>Task Management</summary>
  43. When on the `Kanban Board`-Tab you can `create (n)`, `edit (e)`, `delete (d)`, move between columns (`H`, `L`), or reorder within a column (`J` down / `K` up).
  44. Movement between columns and reordering within a column are also supported via mouse drag and drop.
  45. Task dependencies can be defined, which restrict movement to the `Doing` (start_column).
  46. To have the restrictions available, the status columns must be defined on the settings screen.
  47. </details>
  48. <details><summary>Task Dependencies</summary>
  49. Tasks can have dependencies on other tasks, creating a workflow where certain tasks must be completed before others can proceed.
  50. - **Add Dependencies**: When editing a task, use the dependency selector dropdown to add other tasks as dependencies
  51. - **Remove Dependencies**: Select a dependency in the table and press enter to remove it
  52. - **Blocking Prevention**: Tasks with unfinished dependencies cannot be moved to start/finish columns
  53. - **Circular Detection**: The system prevents circular dependencies (Task A depends on Task B, Task B depends on Task A)
  54. - **Visual Indicators**: Task cards show visual cues for dependency status:
  55. - 🔒 "Blocked by X unfinished tasks" - Task has dependencies that aren't finished yet
  56. - ❗ "Blocking Y tasks" - Other tasks depend on this one
  57. - ✅ "No dependencies" - Task has no dependency relationships
  58. - **CLI Support**: Dependencies can be managed via the CLI with the `--depends-on` flag when creating tasks, or using the `--force` flag to override blocking when moving tasks
  59. </details>
  60. <details><summary>Database Information</summary>
  61. The current database schema looks as follows.
  62. The Audit table is filled automatically based on triggers.
  63. ```mermaid
  64. erDiagram
  65. tasks }|--o| categories: have
  66. tasks }|--|| audits: updates
  67. tasks ||--o{ task_dependencies: "blocks"
  68. tasks ||--o{ task_dependencies: "blocked_by"
  69. tasks {
  70. INTEGER task_id PK
  71. INTEGER column FK
  72. INTEGER category FK
  73. TEXT title
  74. TEXT description
  75. DATETIME creation_date
  76. DATETIME start_date
  77. DATETIME finish_date
  78. DATETIME due_date
  79. TEXT metadata
  80. }
  81. task_dependencies {
  82. INTEGER dependency_id PK
  83. INTEGER task_id FK
  84. INTEGER depends_on_task_id FK
  85. }
  86. boards }|--o{ columns: contains
  87. boards }|--|| audits: updates
  88. boards {
  89. INTEGER board_id PK
  90. INTEGER reset_column FK
  91. INTEGER start_column FK
  92. INTEGER finish_column FK
  93. TEXT name
  94. TEXT icon
  95. DATETIME creation_date
  96. }
  97. columns ||--|{ tasks: contains
  98. columns }|--|| audits: updates
  99. columns {
  100. INTEGER column_id PK
  101. INTEGER board_id FK
  102. TEXT name
  103. BOOLEAN visible
  104. INTEGER position
  105. }
  106. categories {
  107. INTEGER category_id PK
  108. TEXT name
  109. TEXT color
  110. }
  111. audits {
  112. INTEGER event_id PK
  113. DATETIME event_timestamp
  114. TEXT event_type
  115. TEXT object_type
  116. INTEGER object_id
  117. TEXT object_field
  118. TEXT value_old
  119. TEXT value_new
  120. }
  121. ```
  122. </details>
  123. <details><summary>Visual Summary and Audit Table</summary>
  124. To give you an overview over the amount of tasks you `created`, `started` or `finished`, kanban-tui
  125. provides an `Overview`-Tab to show you a bar-chart on a `monthly`, `weekly` or `daily` scale.
  126. It also can be changed to a stacked bar chart per category.
  127. This feature is powered by the [plotext] library with help of [textual-plotext].
  128. There is also an audit table, which tracks the creation/update/deletion of tasks/boards and columns.
  129. </details>
  130. ## Installation
  131. You can install `kanban-tui` with one of the following options:
  132. ```bash
  133. uv tool install kanban-tui
  134. ```
  135. ```bash
  136. pipx install kanban-tui
  137. ```
  138. ```bash
  139. # not recommended
  140. pip install kanban-tui
  141. ```
  142. I recommend using [pipx] or [uv] to install CLI Tools into an isolated environment.
  143. To be able to use `kanban-tui` in your browser with the `--web`-flag, the optional dependency
  144. `textual-serve` is needed. You can add this to `kanban-tui` by installing the optional `web`-dependency
  145. with the installer of your choice, for example with [uv]:
  146. ```bash
  147. uv tool install 'kanban-tui[web]'
  148. ```
  149. ## Usage
  150. kanban-tui now also supports the `kanban-tui` entrypoint besides `ktui`.
  151. This was added to support easier installation via [uv]'s `uvx` command.
  152. ### Normal Mode
  153. Start `kanban-tui` with by just running the tool without any command. The application can be closed by pressing `ctrl+q`.
  154. Pass the `--web` flag and follow the shown link to open `kanban-tui` in your browser.
  155. ```bash
  156. ktui
  157. ```
  158. ### Demo Mode
  159. Creates a temporary Config and Database which is populated with example Tasks to play around.
  160. Kanban-Tui will delete the temporary Config and Database after closing the application.
  161. Pass the `--clean` flag to start with an empty demo app.
  162. Pass the `--keep` flag to tell `kanban-tui` not to delete the temporary Database and Config.
  163. Pass the `--web` flag and follow the shown link to open `kanban-tui` in your browser.
  164. ```bash
  165. ktui demo
  166. ```
  167. ### Clear Database and Configuration
  168. If you want to start with a fresh database and configuration file, you can use this command to
  169. delete your current database and configuration file.
  170. ```bash
  171. ktui clear
  172. ```
  173. ### Create or Update Agent SKILL.md File
  174. With version v0.11.0 kanban-tui offers a [CLI Interface](#cli-interface-to-manage-tasks) to manage tasks, boards and columns.
  175. This is targeted mainly for agentic use e.g. via [Claude][claude-code], because references will be made only by ids, but some commands
  176. are also ergonomic for human use (e.g. task or board creation).
  177. ```bash
  178. ktui skill init/update/delete
  179. ```
  180. ### CLI Interface to manage Tasks
  181. The commands to manage tasks, boards and columns via the CLI are all build up similarly. For detailed overview of arguments
  182. and options please use the `--help` command.
  183. Note that not every functionality is supported yet (e.g. category management, column customisation).
  184. ```bash
  185. ktui task list/create/update/move/delete
  186. ktui board list/create/delete/activate
  187. ktui column list
  188. ```
  189. ### MCP Server
  190. In addition to skills, `kanban-tui` can be run as a local mcp server, which exposes the `ktui task/board/column` commands.
  191. This requires the optional `mcp` dependency, which can be installed via `uv tool install kanban-tui[mcp]`. It utilizes [pycli-mcp]
  192. to directly expose the commands.
  193. Using the bare `ktui mcp` command shows the instruction to add `kanban-tui` mcp to [claude-code]. The server itself is
  194. started using the `--start-server` flag.
  195. ```bash
  196. ktui mcp
  197. ```
  198. ### Show Location of Data, Config and Skill Files
  199. `kanban-tui` follows the [XDG] basedir-spec and uses the [xdg-base-dirs] package to get the locations for data and config files.
  200. You can use this command to check where the files are located, that `kanban-tui` creates on your system.
  201. ```bash
  202. ktui info
  203. ```
  204. ## Feedback and Issues
  205. Feel free to reach out and share your feedback, or open an [Issue],
  206. if something doesn't work as expected.
  207. Also check the [Changelog] for new updates.
  208. <!-- Repo Links -->
  209. [Changelog]: https://github.com/Zaloog/kanban-tui/blob/main/CHANGELOG.md
  210. [Issue]: https://github.com/Zaloog/kanban-tui/issues
  211. <!-- external Links Python -->
  212. [textual]: https://textual.textualize.io
  213. [pipx]: https://github.com/pypa/pipx
  214. [PyPi]: https://pypi.org/project/kanban-tui/
  215. [plotext]: https://github.com/piccolomo/plotext
  216. [textual-plotext]: https://github.com/Textualize/textual-plotext
  217. [xdg-base-dirs]: https://github.com/srstevenson/xdg-base-dirs
  218. [pydantic-settings]: https://pypi.org/project/pydantic-settings/
  219. [pycli-mcp]: https://github.com/ofek/pycli-mcp
  220. <!-- external Links Others -->
  221. [XDG]: https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html
  222. [uv]: https://docs.astral.sh/uv
  223. [claude-code]: https://code.claude.com/docs/en/overview

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.