{"id":25374044,"url":"https://github.com/zaloog/kanban-tui","last_synced_at":"2026-02-20T19:08:47.620Z","repository":{"id":257804810,"uuid":"844917795","full_name":"Zaloog/kanban-tui","owner":"Zaloog","description":"Task Manager with a TUI written in Python","archived":false,"fork":false,"pushed_at":"2026-01-10T16:29:58.000Z","size":8273,"stargazers_count":141,"open_issues_count":7,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-01-11T04:29:04.536Z","etag":null,"topics":["kanban","python","task-manager","textual","tui","uv"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Zaloog.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-08-20T08:14:01.000Z","updated_at":"2026-01-06T16:24:04.000Z","dependencies_parsed_at":null,"dependency_job_id":"3a61a5a7-f790-4d24-af7e-442061a5d05f","html_url":"https://github.com/Zaloog/kanban-tui","commit_stats":null,"previous_names":["zaloog/kanban-tui"],"tags_count":32,"template":false,"template_full_name":null,"purl":"pkg:github/Zaloog/kanban-tui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zaloog%2Fkanban-tui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zaloog%2Fkanban-tui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zaloog%2Fkanban-tui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zaloog%2Fkanban-tui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Zaloog","download_url":"https://codeload.github.com/Zaloog/kanban-tui/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zaloog%2Fkanban-tui/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28479401,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T11:59:17.896Z","status":"ssl_error","status_checked_at":"2026-01-16T11:55:55.838Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["kanban","python","task-manager","textual","tui","uv"],"created_at":"2025-02-15T03:35:41.671Z","updated_at":"2026-01-30T23:04:05.692Z","avatar_url":"https://github.com/Zaloog.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- Icons --\u003e\n[![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)\n[![PyPI-Server](https://img.shields.io/pypi/v/kanban-tui.svg)](https://pypi.org/project/kanban-tui/)\n[![Pyversions](https://img.shields.io/pypi/pyversions/kanban-tui.svg)](https://pypi.python.org/pypi/kanban-tui)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Downloads](https://static.pepy.tech/badge/kanban-tui)](https://pepy.tech/project/kanban-tui)\n[![Coverage Status](https://coveralls.io/repos/github/Zaloog/kanban-tui/badge.svg?branch=main)](https://coveralls.io/github/Zaloog/kanban-tui?branch=main)\n\n# kanban-tui\n\nA customizable terminal-based task manager powered by [Textual][textual] with multiple backends.\nNow also usable in co-op mode with AI agents (check the [CLI interface](#cli-interface) and [MCP Server](#mcp-server) section for more info).\n\n## Demo\n![demo_gif](https://raw.githubusercontent.com/Zaloog/kanban-tui/main/docs/demo.gif)\n\nTry `kanban-tui` instantly without installation:\n\n```bash\nuvx kanban-tui demo\n```\n\n## Features\n\n\u003cdetails\u003e\u003csummary\u003efollowing the xdg basedir convention\u003c/summary\u003e\n\nkanban-tui utilizes [pydantic-settings] and [xdg-base-dirs] `user_config_dir` to save\nthe config file and `user_data_dir` for the sqlite database.\nyou can get an overview of all file locations with `uvx kanban-tui info`\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003eCustomizable Board\u003c/summary\u003e\n\nkanban-tui comes with four default columns\n(`Ready`, `Doing`, `Done`, `Archive`) but can be customized to your needs.\nMore columns can be created via the `Settings`-Tab. Also the visibility and order of columns can be adjusted.\nDeletion of existing columns is only possible, if no task is present in the column you want to delete.\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003eMultiple Backends\u003c/summary\u003e\n\nkanban-tui currently supports three backends.\n- **sqlite** (default) | Supports all features of `kanban-tui`\n- **jira** | Connect to your jira instance via api key and query tasks via jql.\nColumns are defined by task transitions.\n- **claude** | Read the `.json` files under `~/.claude/tasks/`. Boards are created for each session ID.\nSupports only a subset of features\n\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003eMulti Board Support\u003c/summary\u003e\n\nWith version v0.4.0 kanban-tui allows the creation of multiple boards.\nUse `B` on the `Kanban Board`-Tab to get an overview over all Boards including\nthe amount of columns, tasks and the earliest Due Date.\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003eTask Management\u003c/summary\u003e\n\nWhen on the `Kanban Board`-Tab you can `create (n)`, `edit (e)`, `delete (d)` or `move (H, L)` tasks between columns.\nMovement between columns is also supported via mouse drag and drop.\nTask dependencies can be defined, which restrict movement to the `Doing` (start_column).\nTo have the restrictions available, the status columns must be defined on the settings screen.\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003eTask Dependencies\u003c/summary\u003e\n\nTasks can have dependencies on other tasks, creating a workflow where certain tasks must be completed before others can proceed.\n- **Add Dependencies**: When editing a task, use the dependency selector dropdown to add other tasks as dependencies\n- **Remove Dependencies**: Select a dependency in the table and press enter to remove it\n- **Blocking Prevention**: Tasks with unfinished dependencies cannot be moved to start/finish columns\n- **Circular Detection**: The system prevents circular dependencies (Task A depends on Task B, Task B depends on Task A)\n- **Visual Indicators**: Task cards show visual cues for dependency status:\n  - 🔒 \"Blocked by X unfinished tasks\" - Task has dependencies that aren't finished yet\n  - ❗ \"Blocking Y tasks\" - Other tasks depend on this one\n  - ✅ \"No dependencies\" - Task has no dependency relationships\n- **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\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003eDatabase Information\u003c/summary\u003e\nThe current database schema looks as follows.\nThe Audit table is filled automatically based on triggers.\n\n```mermaid\nerDiagram\n    tasks }|--o| categories: have\n    tasks }|--|| audits: updates\n    tasks ||--o{ task_dependencies: \"blocks\"\n    tasks ||--o{ task_dependencies: \"blocked_by\"\n    tasks {\n        INTEGER task_id PK\n        INTEGER column FK\n        INTEGER category FK\n        TEXT title\n        TEXT description\n        DATETIME creation_date\n        DATETIME start_date\n        DATETIME finish_date\n        DATETIME due_date\n        TEXT metadata\n    }\n    task_dependencies {\n        INTEGER dependency_id PK\n        INTEGER task_id FK\n        INTEGER depends_on_task_id FK\n    }\n    boards }|--o{ columns: contains\n    boards }|--|| audits: updates\n    boards {\n        INTEGER board_id PK\n        INTEGER reset_column FK\n        INTEGER start_column FK\n        INTEGER finish_column FK\n        TEXT name\n        TEXT icon\n        DATETIME creation_date\n    }\n    columns ||--|{ tasks: contains\n    columns }|--|| audits: updates\n    columns {\n        INTEGER column_id PK\n        INTEGER board_id FK\n        TEXT name\n        BOOLEAN visible\n        INTEGER position\n    }\n    categories {\n        INTEGER category_id PK\n        TEXT name\n        TEXT color\n    }\n    audits {\n        INTEGER event_id PK\n        DATETIME event_timestamp\n        TEXT event_type\n        TEXT object_type\n        INTEGER object_id\n        TEXT object_field\n        TEXT value_old\n        TEXT value_new\n    }\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003eVisual Summary and Audit Table\u003c/summary\u003e\n\nTo give you an overview over the amount of tasks you `created`, `started` or `finished`, kanban-tui\nprovides an `Overview`-Tab to show you a bar-chart on a `monthly`, `weekly` or `daily` scale.\nIt also can be changed to a stacked bar chart per category.\nThis feature is powered by the [plotext] library with help of [textual-plotext].\nThere is also an audit table, which tracks the creation/update/deletion of tasks/boards and columns.\n\u003c/details\u003e\n\n## Installation\n\nYou can install `kanban-tui` with one of the following options:\n\n```bash\nuv tool install kanban-tui\n```\n\n```bash\npipx install kanban-tui\n```\n\n```bash\n# not recommended\npip install kanban-tui\n```\n\nI recommend using [pipx] or [uv] to install CLI Tools into an isolated environment.\n\nTo be able to use `kanban-tui` in your browser with the `--web`-flag, the optional dependency\n`textual-serve` is needed. You can add this to `kanban-tui` by installing the optional `web`-dependency\nwith the installer of your choice, for example with [uv]:\n\n```bash\nuv tool install 'kanban-tui[web]'\n```\n\n\n## Usage\nkanban-tui now also supports the `kanban-tui` entrypoint besides `ktui`.\nThis was added to support easier installation via [uv]'s `uvx` command.\n\n### Normal Mode\nStart `kanban-tui` with by just running the tool without any command. The application can be closed by pressing `ctrl+q`.\nPass the `--web` flag and follow the shown link to open `kanban-tui` in your browser.\n```bash\nktui\n```\n\n### Demo Mode\nCreates a temporary Config and Database which is populated with example Tasks to play around.\nKanban-Tui will delete the temporary Config and Database after closing the application.\nPass the `--clean` flag to start with an empty demo app.\nPass the `--keep` flag to tell `kanban-tui` not to delete the temporary Database and Config.\nPass the `--web` flag and follow the shown link to open `kanban-tui` in your browser.\n\n```bash\nktui demo\n```\n\n### Clear Database and Configuration\nIf you want to start with a fresh database and configuration file, you can use this command to\ndelete your current database and configuration file.\n\n```bash\nktui clear\n```\n\n### Create or Update Agent SKILL.md File\nWith version v0.11.0 kanban-tui offers a [CLI Interface](#cli-interface-to-manage-tasks) to manage tasks, boards and columns.\nThis is targeted mainly for agentic use e.g. via [Claude][claude-code], because references will be made only by ids, but some commands\nare also ergonomic for human use (e.g. task or board creation).\n\n```bash\nktui skill init/update/delete\n```\n\n### CLI Interface to manage Tasks\nThe commands to manage tasks, boards and columns via the CLI are all build up similarly. For detailed overview of arguments\nand options please use the `--help` command.\nNote that not every functionality is supported yet (e.g. category management, column customisation).\n\n```bash\nktui task list/create/update/move/delete\nktui board list/create/delete/activate\nktui column list\n```\n\n### MCP Server\nIn addition to skills, `kanban-tui` can be run as a local mcp server, which exposes the `ktui task/board/column` commands.\nThis requires the optional `mcp` dependency, which can be installed via `uv tool install kanban-tui[mcp]`. It utilizes [pycli-mcp]\nto directly expose the commands.\nUsing the bare `ktui mcp` command shows the instruction to add `kanban-tui` mcp to [claude-code]. The server itself is\nstarted using the `--start-server` flag.\n\n```bash\nktui mcp\n```\n\n### Show Location of Data, Config and Skill Files\n`kanban-tui` follows the [XDG] basedir-spec and uses the [xdg-base-dirs] package to get the locations for data and config files.\nYou can use this command to check where the files are located, that `kanban-tui` creates on your system.\n\n```bash\nktui info\n```\n\n## Feedback and Issues\nFeel free to reach out and share your feedback, or open an [Issue],\nif something doesn't work as expected.\nAlso check the [Changelog] for new updates.\n\n\n\u003c!-- Repo Links --\u003e\n[Changelog]: https://github.com/Zaloog/kanban-tui/blob/main/CHANGELOG.md\n[Issue]: https://github.com/Zaloog/kanban-tui/issues\n\n\n\u003c!-- external Links Python --\u003e\n[textual]: https://textual.textualize.io\n[pipx]: https://github.com/pypa/pipx\n[PyPi]: https://pypi.org/project/kanban-tui/\n[plotext]: https://github.com/piccolomo/plotext\n[textual-plotext]: https://github.com/Textualize/textual-plotext\n[xdg-base-dirs]: https://github.com/srstevenson/xdg-base-dirs\n[pydantic-settings]: https://pypi.org/project/pydantic-settings/\n[pycli-mcp]: https://github.com/ofek/pycli-mcp\n\n\u003c!-- external Links Others --\u003e\n[XDG]: https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html\n[uv]: https://docs.astral.sh/uv\n[claude-code]: https://code.claude.com/docs/en/overview\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzaloog%2Fkanban-tui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzaloog%2Fkanban-tui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzaloog%2Fkanban-tui/lists"}