tuidoscope 0.1.14 → 0.1.16
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +49 -25
- package/dist/index.js +5226 -6390
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -20,11 +20,13 @@ A centralized TUI management application for running multiple TUI applications i
|
|
|
20
20
|
|
|
21
21
|
- **Embedded Terminals**: Run multiple TUIs in a single window using Ghostty's high-performance terminal emulator.
|
|
22
22
|
- **Tab Management**: Organize and switch between different applications using a vertical sidebar.
|
|
23
|
-
- **
|
|
23
|
+
- **Simple Modal Keyboard**: Two modes - TABS mode for navigation and TERMINAL mode for PTY input. Toggle with `Ctrl+A`.
|
|
24
|
+
- **Command Palette**: Quickly search and switch between apps with a fuzzy-search palette (`Space`).
|
|
24
25
|
- **Runtime Management**: Add, edit, and remove application entries directly within the app without restarting.
|
|
25
26
|
- **Session Persistence**: Automatically remembers and restores your running applications and active tab between restarts.
|
|
26
|
-
- **Highly Configurable**: Customize themes
|
|
27
|
-
- **Path Expansion**: Supports
|
|
27
|
+
- **Highly Configurable**: Customize themes and application lists via YAML.
|
|
28
|
+
- **Path Expansion**: Supports `~`, `<CONFIG_DIR>`, and `<STATE_DIR>` tokens in paths.
|
|
29
|
+
- **App Availability Detection**: Add Tab modal shows which TUI apps are installed on your system.
|
|
28
30
|
|
|
29
31
|
## Documentation
|
|
30
32
|
|
|
@@ -32,10 +34,11 @@ For detailed guides, see the [`docs/`](./docs/) directory:
|
|
|
32
34
|
|
|
33
35
|
- [Getting Started](./docs/getting-started.md) - Installation and first run
|
|
34
36
|
- [Configuration](./docs/configuration.md) - YAML config reference
|
|
35
|
-
- [Keybindings](./docs/keybindings.md) - Leader key system and shortcuts
|
|
36
37
|
- [Apps](./docs/apps.md) - App configuration examples
|
|
37
38
|
- [Troubleshooting](./docs/troubleshooting.md) - Common issues and solutions
|
|
38
39
|
|
|
40
|
+
See also: [CONFIG.md](./CONFIG.md) for a comprehensive configuration reference.
|
|
41
|
+
|
|
39
42
|
## Tech Stack
|
|
40
43
|
|
|
41
44
|
- **Runtime**: [Bun](https://bun.sh/)
|
|
@@ -103,39 +106,60 @@ bun run typecheck
|
|
|
103
106
|
|
|
104
107
|
## Configuration
|
|
105
108
|
|
|
106
|
-
Tuidoscope looks for a configuration file at `~/.config/tuidoscope/
|
|
109
|
+
Tuidoscope looks for a configuration file at `~/.config/tuidoscope/tuidoscope.yaml`. It also supports a local `tuidoscope.yaml` in the current working directory for project-specific setups.
|
|
110
|
+
|
|
111
|
+
### Keyboard Shortcuts
|
|
112
|
+
|
|
113
|
+
Tuidoscope uses a simple two-mode system:
|
|
107
114
|
|
|
108
|
-
|
|
115
|
+
- **`Ctrl+A`** - Toggle between TABS and TERMINAL mode
|
|
116
|
+
- **Double-tap `Ctrl+A`** - Send `Ctrl+A` to the terminal (useful for nested tmux/screen)
|
|
109
117
|
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
|
113
|
-
|
|
114
|
-
|
|
|
115
|
-
|
|
|
116
|
-
|
|
|
117
|
-
|
|
|
118
|
-
|
|
|
119
|
-
|
|
|
120
|
-
|
|
|
121
|
-
|
|
|
122
|
-
|
|
|
118
|
+
**TABS Mode** (single keystrokes):
|
|
119
|
+
|
|
120
|
+
| Key | Action |
|
|
121
|
+
|-----|--------|
|
|
122
|
+
| `j` / `k` | Navigate down/up in tab list |
|
|
123
|
+
| `gg` | Jump to first tab |
|
|
124
|
+
| `G` | Jump to last tab |
|
|
125
|
+
| `Enter` | Select/start app |
|
|
126
|
+
| `Space` | Open command palette |
|
|
127
|
+
| `t` | Add new tab |
|
|
128
|
+
| `e` | Edit selected app |
|
|
129
|
+
| `x` | Stop selected app |
|
|
130
|
+
| `r` | Restart selected app |
|
|
131
|
+
| `K` | Kill all running apps |
|
|
132
|
+
| `q` | Quit tuidoscope |
|
|
133
|
+
|
|
134
|
+
**TERMINAL Mode**: All keystrokes pass through to the embedded terminal.
|
|
123
135
|
|
|
124
136
|
### Theme Customization
|
|
125
137
|
|
|
126
|
-
|
|
138
|
+
Default theme is Night Owl. Customize in your `tuidoscope.yaml`:
|
|
127
139
|
|
|
128
140
|
```yaml
|
|
129
141
|
theme:
|
|
130
|
-
primary: "#
|
|
131
|
-
background: "#
|
|
132
|
-
foreground: "#
|
|
133
|
-
accent: "#
|
|
134
|
-
muted: "#
|
|
142
|
+
primary: "#82aaff" # Blue - selections
|
|
143
|
+
background: "#011627" # Deep dark blue
|
|
144
|
+
foreground: "#d6deeb" # Light text
|
|
145
|
+
accent: "#7fdbca" # Cyan - active indicators
|
|
146
|
+
muted: "#637777" # Gray - inactive elements
|
|
135
147
|
```
|
|
136
148
|
|
|
137
149
|
## Change Log
|
|
138
150
|
|
|
151
|
+
### v0.3.0
|
|
152
|
+
- **Simplified Keyboard System**: Replaced tmux-style leader key with simple focus-toggle model using `Ctrl+A`.
|
|
153
|
+
- **Two-Mode Interface**: TABS mode for navigation (single keystrokes) and TERMINAL mode for PTY input.
|
|
154
|
+
- **Enhanced Add Tab Modal**: Now shows app presets with availability detection directly in the modal.
|
|
155
|
+
- **Streamlined Config**: Removed keybinds configuration - keyboard shortcuts are now fixed for consistency.
|
|
156
|
+
|
|
157
|
+
### v0.2.0
|
|
158
|
+
- **Leader Key System**: tmux-style configurable leader key (default `Ctrl+A`).
|
|
159
|
+
- **App Availability Detection**: Preset list shows which apps are installed on your system.
|
|
160
|
+
- **Expanded Presets**: 30+ TUI apps including AI coding agents (Claude, OpenCode, Aider, Gemini, Codex).
|
|
161
|
+
- **Night Owl Theme**: Updated default theme to Night Owl color scheme.
|
|
162
|
+
|
|
139
163
|
### v0.1.0
|
|
140
164
|
- Initial release.
|
|
141
165
|
- Embedded terminal windows via `ghostty-opentui`.
|