xtui 0.2.0

TUI for discovering and running project commands (xtask, cargo, just, nu, npm, make, mise)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

# xtui

[![crates.io](https://img.shields.io/crates/v/xtui.svg)](https://crates.io/crates/xtui)

A terminal UI for discovering and running project commands. Point it at any
project directory and it finds runnable commands from 8 sources, organizes
them into tabs, and lets you run them with live streaming output.

## Sources

| Source    | Detects                            | Runs via                      |
| --------- | ---------------------------------- | ----------------------------- |
| xtask     | `xtask/src/main.rs` match arms     | `cargo run -p xtask -- <cmd>` |
| cargo     | `Cargo.toml` (+ `[[bin]]` targets) | `cargo <cmd>`                 |
| just      | `Justfile` / `justfile`            | `just <recipe>`               |
| nu        | `scripts/*.nu`                     | `nu scripts/<name>.nu`        |
| npm       | `package.json` scripts             | `npm run <script>`            |
| make      | `Makefile` targets                 | `make <target>`               |
| mise      | `mise.toml` / `.mise.toml` tasks   | `mise run <task>`             |
| cargo-bin | `~/.cargo/bin/` executables        | `<binary>`                    |

## Usage

```sh
# Run in current directory
xtui

# Run against a specific project
xtui /path/to/project
xtui --path /path/to/project
```

## Keybindings

| Key                 | Action                                        |
| ------------------- | --------------------------------------------- |
| `j` / `k` / arrows  | Navigate commands or scroll output            |
| `Tab` / `Shift+Tab` | Cycle source tabs                             |
| `1`-`9`             | Jump to tab by index                          |
| `Enter`             | Run selected command                          |
| `o`                 | Focus output pane                             |
| `Esc`               | Cancel running command / exit output focus    |
| `Ctrl+C`            | Cancel running command or quit                |
| `/`                 | Search output                                 |
| `n` / `N`           | Next / previous search match                  |
| `s`                 | Toggle git status tab                         |
| `r`                 | Refresh commands                              |
| `c`                 | Copy output to clipboard (OSC 52)             |
| `P`                 | Run all commands in current tab as a pipeline |
| `q`                 | Quit                                          |

## Features

- **Tabbed sources**: each source gets its own tab with discovered commands
- **Live output**: stdout/stderr streamed in real time with ANSI color support
- **Git status bar**: branch, dirty/clean, ahead/behind, recent commits
- **Output search**: incremental case-insensitive search with match cycling
- **Pipelines**: run all commands in a tab sequentially, stop on failure
- **History**: last 50 runs per project saved to `~/.config/xtui/history/`
- **Output logs**: command output persisted as `.log` files (max 100 per project)

## Install

```sh
cargo install xtui
```

## Building from source

```sh
cargo build --release

# Or install to ~/.cargo/bin
cargo xtask install
```

## Testing

```sh
# Unit + integration tests (fixture-based)
cargo test

# Include real-repo tests (requires local repos)
cargo test -- --ignored
```

## Project Structure

```
src/
  main.rs       Entry point, workspace resolution
  app.rs        App state, event loop, key handling
  ui.rs         Ratatui rendering (layout, tabs, output, status)
  source.rs     CommandSource trait + 8 implementations
  discover.rs   Xtask main.rs parser (regex-based)
  runner.rs     Async process spawning and output streaming
  pipeline.rs   Sequential command chaining state machine
  search.rs     Output search with match tracking
  history.rs    Run history and output log persistence
  status.rs     Git status collection
  registry.rs   Project discovery and cache (unused in v1)
xtask/
  src/main.rs   Dev tasks: check, test, clippy, install
tests/
  common/       Shared fixture builder
  integration.rs  Cross-module integration tests
  sources.rs    Per-source integration tests
```

## License

MIT OR Apache-2.0