Metadata-Version: 2.4
Name: tk-ui
Version: 0.1.0
Summary: Kanban-style ticket viewer TUI for pi .tickets/ directories
Project-URL: Homepage, https://github.com/volker/pi-rw-ticket
Project-URL: Repository, https://github.com/volker/pi-rw-ticket
Author: Volker
License-Expression: MIT
License-File: LICENSE
Keywords: kanban,pi,textual,ticket,tui
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Bug Tracking
Classifier: Topic :: Utilities
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: pyyaml>=6.0
Requires-Dist: textual>=0.47.0
Description-Content-Type: text/markdown

# tk-ui

A Kanban-style ticket viewer TUI for [pi](https://github.com/mariozechner/pi) `.tickets/` directories.

Built with [Textual](https://textual.textualize.io/).

## Install

```bash
pip install tk-ui
```

Or with uv:

```bash
uv tool install tk-ui
```

## Usage

Run from any directory that contains a `.tickets/` folder with markdown ticket files:

```bash
tk-ui
```

Or specify a path:

```bash
tk-ui /path/to/project
```

### Ticket Format

Tickets are `.md` files in `.tickets/` with YAML frontmatter:

```markdown
---
id: TODO-abc123
title: My ticket
status: in-progress
priority: high
dependencies: []
---

Ticket description here.
```

### Board Columns

| Column | Tickets with status |
|--------|-------------------|
| **Ready** | `ready`, `todo` |
| **Blocked** | `blocked` or has unresolved dependencies |
| **In Progress** | `in-progress` |
| **Closed** | `closed`, `done` |

### Key Bindings

| Key | Action |
|-----|--------|
| `q` | Quit |
| `r` | Refresh board |
| `o` | Open ticket in editor |
| `e` | Expand/collapse description |
| `?` | Show help |
| Tab / Shift+Tab | Cycle focus between columns |
| ↑ / ↓ | Navigate tickets |
| Enter | Select ticket |

## License

MIT
