Build the core HTTP client with rate limiting, retry, and pagination in clickup-api. Use this when creating client.rs, rate_limiter.rs, or pagination.rs.

2026-03-213

cli-auth

Rynaro/termaup

Implement authentication commands for clickup-cli. Use this when creating auth.rs, output.rs, or client_factory.rs in the CLI crate.

2026-03-173

cli-data

Rynaro/termaup

Implement space, list, and task browsing commands with rich output for clickup-cli. Use this when creating data browsing commands in the CLI crate.

2026-03-173

name	tui-workspaces
description	Implement workspace and space selection screens with async data loading in clickup-tui. Use this when building the first TUI data screens.

TUI Workspace & Space Screens

Context

This skill creates the first real data-driven TUI screens — workspace selection and space listing — along with the async data loading system and keyboard input routing.

Crates

clickup-tui

Prerequisites

Skill tui-scaffold completed — app skeleton, event loop, layout framework exist

Deliverables

crates/clickup-tui/src/data.rs — Async loader functions that send DataPayload events
crates/clickup-tui/src/ui/workspace_select.rs — Selectable workspace list
crates/clickup-tui/src/ui/space_list.rs — Selectable space list with private indicators
crates/clickup-tui/src/input.rs — Key routing per screen

Implementation

data.rs

Async loading pattern — never block the main thread:

pub fn load_workspaces(client: Arc<ClickUpClient>, tx: mpsc::Sender<AppEvent>) {
    tokio::spawn(async move {
        match client.get_workspaces().await {
            Ok(workspaces) => { tx.send(AppEvent::Data(DataPayload::Workspaces(workspaces))).await.ok(); }
            Err(e) => { tx.send(AppEvent::Data(DataPayload::Error(e.to_string()))).await.ok(); }
        }
    });
}

One function per data load: load_workspaces, load_spaces, load_tasks, etc.
All functions take Arc<ClickUpClient> and mpsc::Sender<AppEvent>
Results sent as DataPayload variants through the event channel
Errors sent as DataPayload::Error(String) — displayed in the status bar

input.rs

Dispatch key events based on current Screen:

pub fn handle_key(app: &mut App, key: KeyEvent, /* ... */) {
    match app.screen {
        Screen::WorkspaceSelect => handle_workspace_keys(app, key),
        Screen::SpaceList => handle_space_keys(app, key),
        // ...
    }
}

Navigation keys (consistent across all list screens):

j / ↓: select next item (wrap to top)
k / ↑: select previous item (wrap to bottom)
Enter: drill into selected item (push breadcrumb, change screen, load data)
Esc: go back one screen (pop breadcrumb)
q / Ctrl+C: quit
r: refresh current data

ui/workspace_select.rs

Render a ratatui::widgets::List of workspace names
Highlight selected item with inverted colors
Show member count next to each workspace name
On Enter: store selected workspace, push breadcrumb, switch to SpaceList, load spaces

ui/space_list.rs

Render a ratatui::widgets::List of space names
Show lock icon (🔒) next to private spaces
Show space color as a colored dot or prefix
On Enter: store selected space, push breadcrumb, switch to ListView, load lists/tasks

Loading state

Show a spinner or "Loading..." in the status bar while data is being fetched
Disable navigation while loading to prevent double-requests

Acceptance

Launch TUI → workspaces load automatically → list appears
j/k navigate the workspace list with wrapping
Enter on a workspace → spaces load → space list appears
Esc from space list → back to workspace list (no re-fetch)
r refreshes current data
Loading state is visible during API calls
Private spaces show a lock indicator