Add TUI launcher implementation and project docs
Source modules for history parsing, git metadata, project scanning, terminal launching, and OpenTUI component layout. Remove private flag for publishing. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Alejandro Gutiérrez
520
docs/launch-claude-original.sh
Executable file
520
docs/launch-claude-original.sh
Executable file
@@ -0,0 +1,520 @@
|
||||
#!/bin/bash
|
||||
# Launch Claude Code in new Terminal windows for selected project folders
|
||||
# Discovers projects from Claude's own conversation history + filesystem scan
|
||||
#
|
||||
# Usage:
|
||||
# ./launch-claude.sh # Interactive picker (default: history mode)
|
||||
# ./launch-claude.sh --all # Launch all detected projects
|
||||
# ./launch-claude.sh --scan # Filesystem scan mode (ignore history)
|
||||
# ./launch-claude.sh --depth 5 # Scan depth for filesystem mode (default: 3)
|
||||
# ./launch-claude.sh arrio nuc # Launch specific folders directly
|
||||
|
||||
# ─── CONFIG ───────────────────────────────────────────────────────────
|
||||
SCAN_ROOT="$HOME/Desktop"
|
||||
MAX_DEPTH=3
|
||||
CLAUDE_HISTORY="$HOME/.claude/history.jsonl"
|
||||
CLAUDE_PROJECTS="$HOME/.claude/projects"
|
||||
# ──────────────────────────────────────────────────────────────────────
|
||||
|
||||
MODE="history" # history or scan
|
||||
|
||||
# Parse flags
|
||||
while [[ $# -gt 0 ]]; do
|
||||
case "$1" in
|
||||
--depth) MAX_DEPTH="$2"; shift 2 ;;
|
||||
--scan) MODE="scan"; shift ;;
|
||||
--all) MODE="all"; shift ;;
|
||||
*) break ;;
|
||||
esac
|
||||
done
|
||||
|
||||
# ─── HELPERS ──────────────────────────────────────────────────────────
|
||||
|
||||
is_project() {
|
||||
local dir="$1"
|
||||
[ -d "$dir/.git" ] || [ -f "$dir/package.json" ] || [ -f "$dir/pyproject.toml" ] || \
|
||||
[ -f "$dir/setup.py" ] || [ -f "$dir/requirements.txt" ] || [ -f "$dir/Cargo.toml" ] || \
|
||||
[ -f "$dir/go.mod" ] || [ -f "$dir/Gemfile" ] || [ -f "$dir/composer.json" ] || \
|
||||
[ -f "$dir/CLAUDE.md" ] || [ -f "$dir/Dockerfile" ] || [ -f "$dir/docker-compose.yml" ] || \
|
||||
[ -f "$dir/docker-compose.yaml" ]
|
||||
}
|
||||
|
||||
find_projects_recursive() {
|
||||
local dir="$1" depth="$2"
|
||||
[[ $depth -gt $MAX_DEPTH ]] && return
|
||||
for sub in "$dir"/*/; do
|
||||
[[ ! -d "$sub" ]] && continue
|
||||
local name=$(basename "$sub")
|
||||
[[ "$name" == .* || "$name" == "node_modules" || "$name" == "vendor" || \
|
||||
"$name" == "venv" || "$name" == ".venv" || "$name" == "__pycache__" || \
|
||||
"$name" == "dist" || "$name" == "build" || "$name" == ".next" || \
|
||||
"$name" == "target" ]] && continue
|
||||
if is_project "$sub"; then
|
||||
echo "$sub"
|
||||
else
|
||||
find_projects_recursive "$sub" $((depth + 1))
|
||||
fi
|
||||
done 2>/dev/null
|
||||
}
|
||||
|
||||
get_tags() {
|
||||
local dir="$1" tags=""
|
||||
[ -d "$dir/.git" ] && tags="${tags}git,"
|
||||
[ -f "$dir/package.json" ] && tags="${tags}node,"
|
||||
{ [ -f "$dir/pyproject.toml" ] || [ -f "$dir/setup.py" ] || [ -f "$dir/requirements.txt" ]; } && tags="${tags}py,"
|
||||
[ -f "$dir/Cargo.toml" ] && tags="${tags}rust,"
|
||||
[ -f "$dir/go.mod" ] && tags="${tags}go,"
|
||||
[ -f "$dir/CLAUDE.md" ] && tags="${tags}claude,"
|
||||
{ [ -f "$dir/Dockerfile" ] || [ -f "$dir/docker-compose.yml" ] || [ -f "$dir/docker-compose.yaml" ]; } && tags="${tags}docker,"
|
||||
echo "${tags%,}"
|
||||
}
|
||||
|
||||
get_relative_path() {
|
||||
local rel="${1#$SCAN_ROOT/}"
|
||||
echo "${rel%/}"
|
||||
}
|
||||
|
||||
get_git_branch() {
|
||||
git -C "$1" rev-parse --abbrev-ref HEAD 2>/dev/null || echo "-"
|
||||
}
|
||||
|
||||
get_last_commit() {
|
||||
git -C "$1" log -1 --format="%ar|%s" 2>/dev/null || echo "-|-"
|
||||
}
|
||||
|
||||
get_dirty_status() {
|
||||
local dir="$1"
|
||||
git -C "$dir" rev-parse --git-dir &>/dev/null || return
|
||||
local staged=$(git -C "$dir" diff --cached --numstat 2>/dev/null | wc -l | tr -d ' ')
|
||||
local unstaged=$(git -C "$dir" diff --numstat 2>/dev/null | wc -l | tr -d ' ')
|
||||
local untracked=$(git -C "$dir" ls-files --others --exclude-standard 2>/dev/null | wc -l | tr -d ' ')
|
||||
local parts=""
|
||||
[[ "$staged" -gt 0 ]] && parts="${parts}+${staged} "
|
||||
[[ "$unstaged" -gt 0 ]] && parts="${parts}~${unstaged} "
|
||||
[[ "$untracked" -gt 0 ]] && parts="${parts}?${untracked} "
|
||||
echo "${parts% }"
|
||||
}
|
||||
|
||||
time_ago_epoch_ms() {
|
||||
local ms="$1"
|
||||
[[ "$ms" == "0" || -z "$ms" ]] && echo "never" && return
|
||||
local now_ms=$(($(date +%s) * 1000))
|
||||
local diff_s=$(( (now_ms - ms) / 1000 ))
|
||||
if (( diff_s < 60 )); then echo "just now"
|
||||
elif (( diff_s < 3600 )); then echo "$((diff_s/60))m ago"
|
||||
elif (( diff_s < 86400 )); then echo "$((diff_s/3600))h ago"
|
||||
elif (( diff_s < 604800 )); then echo "$((diff_s/86400))d ago"
|
||||
elif (( diff_s < 2592000 )); then echo "$((diff_s/604800))w ago"
|
||||
else echo "$((diff_s/2592000))mo ago"
|
||||
fi
|
||||
}
|
||||
|
||||
launch_folders() {
|
||||
local count=0
|
||||
for dir in "$@"; do
|
||||
local name=$(get_relative_path "$dir")
|
||||
osascript -e "
|
||||
tell application \"Terminal\"
|
||||
activate
|
||||
do script \"cd '$dir' && claude --dangerously-skip-permissions\"
|
||||
end tell
|
||||
"
|
||||
echo " ✓ $name"
|
||||
((count++))
|
||||
sleep 0.3
|
||||
done
|
||||
echo ""
|
||||
echo "Done! $count terminals launched."
|
||||
}
|
||||
|
||||
# ─── BUILD PROJECT LIST FROM HISTORY ──────────────────────────────────
|
||||
|
||||
build_from_history() {
|
||||
python3 -c "
|
||||
import json, os, sys
|
||||
from collections import defaultdict
|
||||
|
||||
scan_root = '$SCAN_ROOT'
|
||||
projects = defaultdict(lambda: {'sessions': set(), 'msgs': 0, 'last': 0})
|
||||
|
||||
with open(os.path.expanduser('$CLAUDE_HISTORY')) as f:
|
||||
for line in f:
|
||||
try:
|
||||
d = json.loads(line)
|
||||
p = d.get('project', '')
|
||||
ts = d.get('timestamp', 0)
|
||||
sid = d.get('sessionId', '')
|
||||
# Only include projects under SCAN_ROOT, exclude SCAN_ROOT itself
|
||||
if p and p.startswith(scan_root + '/') and p != scan_root:
|
||||
projects[p]['sessions'].add(sid)
|
||||
projects[p]['msgs'] += 1
|
||||
projects[p]['last'] = max(projects[p]['last'], ts)
|
||||
except:
|
||||
pass
|
||||
|
||||
# Output: path|sessions|msgs|last_timestamp_ms
|
||||
# Only include dirs that still exist
|
||||
for p, info in sorted(projects.items(), key=lambda x: -x[1]['last']):
|
||||
if os.path.isdir(p):
|
||||
print(f\"{p}|{len(info['sessions'])}|{info['msgs']}|{info['last']}\")
|
||||
" 2>/dev/null
|
||||
}
|
||||
|
||||
# ─── BUILD PROJECT LIST FROM FILESYSTEM ───────────────────────────────
|
||||
|
||||
build_from_scan() {
|
||||
find_projects_recursive "$SCAN_ROOT" 1
|
||||
}
|
||||
|
||||
# ─── DIRECT LAUNCH MODES ─────────────────────────────────────────────
|
||||
|
||||
if [[ "$MODE" == "all" ]]; then
|
||||
found=()
|
||||
while IFS= read -r line; do found+=("$line"); done < <(build_from_history | cut -d'|' -f1)
|
||||
if [[ ${#found[@]} -eq 0 ]]; then
|
||||
while IFS= read -r line; do found+=("$line"); done < <(build_from_scan)
|
||||
fi
|
||||
echo "Launching ${#found[@]} projects..."
|
||||
launch_folders "${found[@]}"
|
||||
exit 0
|
||||
fi
|
||||
|
||||
if [[ $# -gt 0 ]]; then
|
||||
folders=()
|
||||
for name in "$@"; do
|
||||
dir="$SCAN_ROOT/$name"
|
||||
[[ -d "$dir" ]] && folders+=("$dir") || echo "⚠ Skipping '$name' — not found"
|
||||
done
|
||||
launch_folders "${folders[@]}"
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# ─── GATHER PROJECT DATA ─────────────────────────────────────────────
|
||||
|
||||
clear
|
||||
history_lines=()
|
||||
scan_lines=()
|
||||
if [[ "$MODE" == "history" ]]; then
|
||||
printf "\033[1m Reading Claude history...\033[0m\n"
|
||||
while IFS= read -r line; do history_lines+=("$line"); done < <(build_from_history)
|
||||
else
|
||||
printf "\033[1m Scanning filesystem (depth: %d)...\033[0m\n" "$MAX_DEPTH"
|
||||
while IFS= read -r line; do scan_lines+=("$line"); done < <(build_from_scan)
|
||||
fi
|
||||
|
||||
projects=()
|
||||
project_display=()
|
||||
project_tags=()
|
||||
project_branches=()
|
||||
project_commit_age=()
|
||||
project_commit_msg=()
|
||||
project_dirty=()
|
||||
project_claude_ago=()
|
||||
project_claude_sessions=()
|
||||
project_claude_msgs=()
|
||||
|
||||
idx=0
|
||||
|
||||
if [[ "$MODE" == "history" ]]; then
|
||||
for entry in "${history_lines[@]}"; do
|
||||
[[ -z "$entry" ]] && continue
|
||||
IFS='|' read -r dir sessions msgs last_ts <<< "$entry"
|
||||
|
||||
projects+=("$dir")
|
||||
project_display+=("$(get_relative_path "$dir")")
|
||||
project_tags+=("$(get_tags "$dir")")
|
||||
project_branches+=("$(get_git_branch "$dir")")
|
||||
|
||||
commit_info=$(get_last_commit "$dir")
|
||||
project_commit_age+=("${commit_info%%|*}")
|
||||
cmsg="${commit_info#*|}"
|
||||
[[ ${#cmsg} -gt 30 ]] && cmsg="${cmsg:0:27}..."
|
||||
project_commit_msg+=("$cmsg")
|
||||
|
||||
project_dirty+=("$(get_dirty_status "$dir")")
|
||||
project_claude_ago+=("$(time_ago_epoch_ms "$last_ts")")
|
||||
project_claude_sessions+=("$sessions")
|
||||
project_claude_msgs+=("$msgs")
|
||||
|
||||
((idx++))
|
||||
printf "\r\033[K\033[2m Loading %d projects...\033[0m" "$idx"
|
||||
done
|
||||
else
|
||||
for dir in "${scan_lines[@]}"; do
|
||||
[[ -z "$dir" ]] && continue
|
||||
|
||||
projects+=("$dir")
|
||||
project_display+=("$(get_relative_path "$dir")")
|
||||
project_tags+=("$(get_tags "$dir")")
|
||||
project_branches+=("$(get_git_branch "$dir")")
|
||||
|
||||
commit_info=$(get_last_commit "$dir")
|
||||
project_commit_age+=("${commit_info%%|*}")
|
||||
cmsg="${commit_info#*|}"
|
||||
[[ ${#cmsg} -gt 30 ]] && cmsg="${cmsg:0:27}..."
|
||||
project_commit_msg+=("$cmsg")
|
||||
|
||||
project_dirty+=("$(get_dirty_status "$dir")")
|
||||
project_claude_ago+=("-")
|
||||
project_claude_sessions+=("-")
|
||||
project_claude_msgs+=("-")
|
||||
|
||||
((idx++))
|
||||
printf "\r\033[K\033[2m Scanned %d projects...\033[0m" "$idx"
|
||||
done
|
||||
fi
|
||||
|
||||
total=${#projects[@]}
|
||||
if [[ $total -eq 0 ]]; then
|
||||
echo ""
|
||||
echo "No projects found."
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# ─── INTERACTIVE PICKER ──────────────────────────────────────────────
|
||||
|
||||
selected=()
|
||||
for ((i=0; i<total; i++)); do selected+=(0); done
|
||||
cursor=0
|
||||
|
||||
sort_mode=0
|
||||
if [[ "$MODE" == "history" ]]; then
|
||||
sort_label="recent (claude)"
|
||||
else
|
||||
sort_label="name"
|
||||
fi
|
||||
|
||||
sort_indices=()
|
||||
for ((i=0; i<total; i++)); do sort_indices+=($i); done
|
||||
|
||||
term_lines=$(tput lines)
|
||||
term_cols=$(tput cols)
|
||||
visible=$((term_lines - 8))
|
||||
[[ $visible -lt 5 ]] && visible=5
|
||||
scroll_offset=0
|
||||
|
||||
tput civis
|
||||
trap 'tput cnorm; stty sane' EXIT
|
||||
|
||||
C_RESET="\033[0m"; C_BOLD="\033[1m"; C_DIM="\033[2m"; C_REV="\033[7m"
|
||||
C_GREEN="\033[32m"; C_YELLOW="\033[33m"; C_CYAN="\033[36m"; C_MAGENTA="\033[35m"
|
||||
|
||||
draw() {
|
||||
tput cup 0 0
|
||||
|
||||
local sel_count=0
|
||||
for s in "${selected[@]}"; do ((sel_count+=s)); done
|
||||
|
||||
local source_label="history"
|
||||
[[ "$MODE" == "scan" ]] && source_label="filesystem"
|
||||
|
||||
printf "${C_BOLD} Claude Code Launcher — %d/%d selected ${C_DIM}sort: %s │ source: %s${C_RESET}\033[K\n" \
|
||||
"$sel_count" "$total" "$sort_label" "$source_label"
|
||||
printf " ${C_DIM}↑↓ navigate │ space toggle │ a all │ n none │ s sort │ enter launch │ q quit${C_RESET}\033[K\n"
|
||||
|
||||
if [[ "$MODE" == "history" ]]; then
|
||||
printf " ${C_DIM} %-33s %-8s %-11s %-25s %-9s %-9s %4s %5s %s${C_RESET}\033[K\n" \
|
||||
"PROJECT" "BRANCH" "COMMIT" "MESSAGE" "DIRTY" "LAST USE" "SESS" "MSGS" "STACK"
|
||||
else
|
||||
printf " ${C_DIM} %-33s %-8s %-11s %-25s %-9s %s${C_RESET}\033[K\n" \
|
||||
"PROJECT" "BRANCH" "COMMIT" "MESSAGE" "DIRTY" "STACK"
|
||||
fi
|
||||
|
||||
if ((cursor < scroll_offset)); then scroll_offset=$cursor
|
||||
elif ((cursor >= scroll_offset + visible)); then scroll_offset=$((cursor - visible + 1)); fi
|
||||
|
||||
local end=$((scroll_offset + visible))
|
||||
[[ $end -gt $total ]] && end=$total
|
||||
|
||||
if ((scroll_offset > 0)); then
|
||||
printf " ${C_DIM} ↑ %d more${C_RESET}\033[K\n" "$scroll_offset"
|
||||
else
|
||||
printf "\033[K\n"
|
||||
fi
|
||||
|
||||
for ((row=scroll_offset; row<end; row++)); do
|
||||
local i=${sort_indices[$row]}
|
||||
local display="${project_display[$i]}"
|
||||
local branch="${project_branches[$i]}"
|
||||
local cage="${project_commit_age[$i]}"
|
||||
local cmsg="${project_commit_msg[$i]}"
|
||||
local dirty="${project_dirty[$i]}"
|
||||
local clago="${project_claude_ago[$i]}"
|
||||
local clsess="${project_claude_sessions[$i]}"
|
||||
local clmsgs="${project_claude_msgs[$i]}"
|
||||
local tags="${project_tags[$i]}"
|
||||
local check=" "
|
||||
[[ ${selected[$i]} -eq 1 ]] && check="✓"
|
||||
|
||||
[[ ${#display} -gt 31 ]] && display="${display:0:28}..."
|
||||
[[ ${#branch} -gt 8 ]] && branch="${branch:0:7}…"
|
||||
|
||||
local dirty_col=""
|
||||
if [[ -n "$dirty" ]]; then dirty_col="${C_YELLOW}${dirty}${C_RESET}"
|
||||
else dirty_col="${C_GREEN}clean${C_RESET}"; fi
|
||||
|
||||
local claude_col=""
|
||||
if [[ "$clago" == "never" || "$clago" == "-" ]]; then claude_col="${C_DIM}${clago}${C_RESET}"
|
||||
elif [[ "$clago" == *"m ago"* || "$clago" == *"h ago"* || "$clago" == "just now" ]]; then claude_col="${C_CYAN}${clago}${C_RESET}"
|
||||
elif [[ "$clago" == *"d ago"* ]]; then claude_col="${C_GREEN}${clago}${C_RESET}"
|
||||
else claude_col="${C_DIM}${clago}${C_RESET}"; fi
|
||||
|
||||
# Row highlight
|
||||
if [[ $row -eq $cursor ]]; then
|
||||
if [[ ${selected[$i]} -eq 1 ]]; then
|
||||
printf " ${C_REV}${C_GREEN} [%s]${C_RESET}${C_REV} %-31s ${C_RESET}" "$check" "$display"
|
||||
else
|
||||
printf " ${C_REV} [%s] %-31s ${C_RESET}" "$check" "$display"
|
||||
fi
|
||||
else
|
||||
if [[ ${selected[$i]} -eq 1 ]]; then
|
||||
printf " ${C_GREEN} [%s] %-31s${C_RESET}" "$check" "$display"
|
||||
else
|
||||
printf " [%s] %-31s" "$check" "$display"
|
||||
fi
|
||||
fi
|
||||
|
||||
printf " ${C_MAGENTA}%-8s${C_RESET}" "$branch"
|
||||
printf " ${C_DIM}%-11s${C_RESET}" "$cage"
|
||||
printf " %-25s" "$cmsg"
|
||||
printf " %-11b" "$dirty_col"
|
||||
|
||||
if [[ "$MODE" == "history" ]]; then
|
||||
printf " %-11b" "$claude_col"
|
||||
printf " ${C_DIM}%4s${C_RESET}" "$clsess"
|
||||
printf " ${C_DIM}%5s${C_RESET}" "$clmsgs"
|
||||
fi
|
||||
|
||||
printf " ${C_DIM}%s${C_RESET}" "$tags"
|
||||
printf "\033[K\n"
|
||||
done
|
||||
|
||||
local remaining=$((total - end))
|
||||
if ((remaining > 0)); then
|
||||
printf " ${C_DIM} ↓ %d more${C_RESET}\033[K\n" "$remaining"
|
||||
else
|
||||
printf "\033[K\n"
|
||||
fi
|
||||
|
||||
for ((cl=0; cl<3; cl++)); do printf "\033[K\n"; done
|
||||
}
|
||||
|
||||
clear
|
||||
draw
|
||||
|
||||
while true; do
|
||||
IFS= read -rsn1 key
|
||||
|
||||
case "$key" in
|
||||
$'\x1b')
|
||||
read -rsn2 -t 0.1 seq
|
||||
case "$seq" in
|
||||
'[A') ((cursor > 0)) && ((cursor--)) ;;
|
||||
'[B') ((cursor < total-1)) && ((cursor++)) ;;
|
||||
'[5') read -rsn1 -t 0.1; ((cursor -= visible)); ((cursor < 0)) && cursor=0 ;;
|
||||
'[6') read -rsn1 -t 0.1; ((cursor += visible)); ((cursor >= total)) && cursor=$((total-1)) ;;
|
||||
esac
|
||||
;;
|
||||
' ')
|
||||
local_i=${sort_indices[$cursor]}
|
||||
selected[$local_i]=$(( 1 - ${selected[$local_i]} ))
|
||||
((cursor < total-1)) && ((cursor++))
|
||||
;;
|
||||
'a'|'A')
|
||||
for ((i=0; i<total; i++)); do selected[$i]=1; done
|
||||
;;
|
||||
'n'|'N')
|
||||
for ((i=0; i<total; i++)); do selected[$i]=0; done
|
||||
;;
|
||||
's'|'S')
|
||||
if [[ "$MODE" == "history" ]]; then
|
||||
sort_mode=$(( (sort_mode + 1) % 4 ))
|
||||
case $sort_mode in
|
||||
0) # Default: by recent claude usage (already sorted from history)
|
||||
sort_label="recent (claude)"
|
||||
sort_indices=()
|
||||
for ((i=0; i<total; i++)); do sort_indices+=($i); done
|
||||
;;
|
||||
1) # By name
|
||||
sort_label="name"
|
||||
declare -a name_pairs=()
|
||||
for ((i=0; i<total; i++)); do
|
||||
name_pairs+=("${project_display[$i]}|$i")
|
||||
done
|
||||
sorted=$(printf '%s\n' "${name_pairs[@]}" | sort -t'|' -k1 -f)
|
||||
sort_indices=()
|
||||
while IFS= read -r line; do sort_indices+=("${line##*|}"); done <<< "$sorted"
|
||||
unset name_pairs
|
||||
;;
|
||||
2) # By last commit
|
||||
sort_label="last commit"
|
||||
declare -a epoch_pairs=()
|
||||
for ((i=0; i<total; i++)); do
|
||||
ep=$(git -C "${projects[$i]}" log -1 --format="%ct" 2>/dev/null || echo "0")
|
||||
epoch_pairs+=("$ep:$i")
|
||||
done
|
||||
sorted=$(printf '%s\n' "${epoch_pairs[@]}" | sort -t: -k1 -nr)
|
||||
sort_indices=()
|
||||
while IFS= read -r line; do sort_indices+=("${line#*:}"); done <<< "$sorted"
|
||||
unset epoch_pairs
|
||||
;;
|
||||
3) # By most sessions
|
||||
sort_label="most sessions"
|
||||
declare -a sess_pairs=()
|
||||
for ((i=0; i<total; i++)); do
|
||||
sess_pairs+=("${project_claude_sessions[$i]}:$i")
|
||||
done
|
||||
sorted=$(printf '%s\n' "${sess_pairs[@]}" | sort -t: -k1 -nr)
|
||||
sort_indices=()
|
||||
while IFS= read -r line; do sort_indices+=("${line#*:}"); done <<< "$sorted"
|
||||
unset sess_pairs
|
||||
;;
|
||||
esac
|
||||
else
|
||||
sort_mode=$(( (sort_mode + 1) % 2 ))
|
||||
case $sort_mode in
|
||||
0) sort_label="name"; sort_indices=(); for ((i=0; i<total; i++)); do sort_indices+=($i); done ;;
|
||||
1)
|
||||
sort_label="last commit"
|
||||
declare -a epoch_pairs=()
|
||||
for ((i=0; i<total; i++)); do
|
||||
ep=$(git -C "${projects[$i]}" log -1 --format="%ct" 2>/dev/null || echo "0")
|
||||
epoch_pairs+=("$ep:$i")
|
||||
done
|
||||
sorted=$(printf '%s\n' "${epoch_pairs[@]}" | sort -t: -k1 -nr)
|
||||
sort_indices=()
|
||||
while IFS= read -r line; do sort_indices+=("${line#*:}"); done <<< "$sorted"
|
||||
unset epoch_pairs
|
||||
;;
|
||||
esac
|
||||
fi
|
||||
cursor=0; scroll_offset=0
|
||||
;;
|
||||
''|$'\n')
|
||||
break
|
||||
;;
|
||||
'q'|'Q')
|
||||
tput cnorm; clear
|
||||
echo "Cancelled."
|
||||
exit 0
|
||||
;;
|
||||
esac
|
||||
|
||||
draw
|
||||
done
|
||||
|
||||
tput cnorm; clear
|
||||
|
||||
chosen=()
|
||||
for ((i=0; i<total; i++)); do
|
||||
[[ ${selected[$i]} -eq 1 ]] && chosen+=("${projects[$i]}")
|
||||
done
|
||||
|
||||
if [[ ${#chosen[@]} -eq 0 ]]; then
|
||||
echo "No projects selected."
|
||||
exit 0
|
||||
fi
|
||||
|
||||
echo "Launching ${#chosen[@]} projects..."
|
||||
echo ""
|
||||
launch_folders "${chosen[@]}"
|
||||
529
docs/opentui-api-reference.md
Normal file
529
docs/opentui-api-reference.md
Normal file
@@ -0,0 +1,529 @@
|
||||
# OpenTUI Complete API Reference
|
||||
|
||||
> Source: https://github.com/anomalyco/opentui — v0.1.81
|
||||
> Native terminal UI core written in Zig with TypeScript bindings. Bun >=1.3.0 required.
|
||||
|
||||
## Packages
|
||||
- `@opentui/core` — TypeScript bindings, imperative API, all primitives
|
||||
- `@opentui/solid` — SolidJS reconciler
|
||||
- `@opentui/react` — React reconciler
|
||||
|
||||
---
|
||||
|
||||
## Renderer
|
||||
|
||||
### createCliRenderer(config?)
|
||||
|
||||
```typescript
|
||||
const renderer = await createCliRenderer(config?: CliRendererConfig): Promise<CliRenderer>
|
||||
```
|
||||
|
||||
### CliRendererConfig
|
||||
|
||||
| Property | Type | Default | Description |
|
||||
|---|---|---|---|
|
||||
| `exitOnCtrlC` | boolean | true | Call renderer.destroy() on Ctrl+C |
|
||||
| `targetFps` | number | 30 | Target frames per second |
|
||||
| `maxFps` | number | 60 | Maximum FPS for immediate re-renders |
|
||||
| `useMouse` | boolean | true | Enable mouse input |
|
||||
| `autoFocus` | boolean | true | Focus nearest focusable on click |
|
||||
| `enableMouseMovement` | boolean | true | Track mouse movement |
|
||||
| `useAlternateScreen` | boolean | true | Use alternate screen buffer |
|
||||
| `openConsoleOnError` | boolean | true | Auto-open console on errors |
|
||||
| `exitSignals` | NodeJS.Signals[] | — | Signals triggering cleanup |
|
||||
| `consoleOptions` | ConsoleOptions | — | Console overlay config |
|
||||
| `onDestroy` | () => void | — | Cleanup callback |
|
||||
|
||||
### CliRenderer Methods
|
||||
|
||||
**Lifecycle:** `start()`, `pause()`, `stop()`, `suspend()`, `resume()`, `destroy()`
|
||||
**Rendering:** `requestRender()`, `intermediateRender()`, `idle()`
|
||||
**Input:** `addInputHandler(fn)`, `prependInputHandler(fn)`, `removeInputHandler(fn)`
|
||||
**Mouse:** `enableMouse()`, `disableMouse()`, `setMousePointer()`, `hitTest()`, `dumpHitGrid()`
|
||||
**Selection:** `startSelection()`, `updateSelection()`, `clearSelection()`, `getSelection()`
|
||||
**Terminal:** `setCursorPosition()`, `setCursorStyle()`, `setCursorColor()`, `setTerminalTitle()`
|
||||
**Clipboard:** `copyToClipboardOSC52()`, `clearClipboardOSC52()`, `isOsc52Supported()`
|
||||
**Performance:** `setGatherStats()`, `getStats()`, `resetStats()`
|
||||
**Getters:** `isRunning`, `controlState`, `useMouse`, `resolution`, `capabilities`, `themeMode`
|
||||
|
||||
### Enums
|
||||
|
||||
```typescript
|
||||
enum MouseButton { LEFT, MIDDLE, RIGHT, WHEEL_UP, WHEEL_DOWN }
|
||||
enum RendererControlState { IDLE, AUTO_STARTED, EXPLICIT_STARTED, EXPLICIT_PAUSED, EXPLICIT_SUSPENDED, EXPLICIT_STOPPED }
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Layout System (Yoga/Flexbox)
|
||||
|
||||
### LayoutOptions
|
||||
|
||||
```typescript
|
||||
interface LayoutOptions {
|
||||
width?: number | string
|
||||
height?: number | string
|
||||
minWidth?: number | string
|
||||
maxWidth?: number | string
|
||||
minHeight?: number | string
|
||||
maxHeight?: number | string
|
||||
flexGrow?: number
|
||||
flexShrink?: number
|
||||
flexBasis?: number | string
|
||||
flexDirection?: "row" | "column" | "row-reverse" | "column-reverse"
|
||||
flexWrap?: "wrap" | "nowrap" | "wrap-reverse"
|
||||
justifyContent?: "flex-start" | "flex-end" | "center" | "space-between" | "space-around" | "space-evenly"
|
||||
alignItems?: "flex-start" | "flex-end" | "center" | "stretch" | "baseline"
|
||||
alignSelf?: "auto" | "flex-start" | "flex-end" | "center" | "stretch" | "baseline"
|
||||
alignContent?: "flex-start" | "flex-end" | "center" | "stretch" | "space-between" | "space-around"
|
||||
position?: "relative" | "absolute"
|
||||
top?: number
|
||||
right?: number
|
||||
bottom?: number
|
||||
left?: number
|
||||
padding?: number
|
||||
paddingTop/Right/Bottom/Left?: number
|
||||
margin?: number
|
||||
marginTop/Right/Bottom/Left?: number
|
||||
overflow?: "visible" | "hidden" | "scroll"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## RenderableOptions (extends LayoutOptions)
|
||||
|
||||
```typescript
|
||||
interface RenderableOptions extends LayoutOptions {
|
||||
id?: string
|
||||
zIndex?: number
|
||||
opacity?: number
|
||||
visibility?: "visible" | "hidden"
|
||||
renderBefore?: Function
|
||||
renderAfter?: Function
|
||||
onMouseDown?: (event: MouseEvent) => void
|
||||
onMouseUp?: (event: MouseEvent) => void
|
||||
onClick?: (event: MouseEvent) => void
|
||||
onMouseMove?: (event: MouseEvent) => void
|
||||
onScroll?: (event: MouseEvent) => void
|
||||
onMouseEnter?: (event: MouseEvent) => void
|
||||
onMouseLeave?: (event: MouseEvent) => void
|
||||
onKeyDown?: (key: KeyEvent) => void
|
||||
onPaste?: (event: PasteEvent) => void
|
||||
onSizeChange?: (width: number, height: number) => void
|
||||
}
|
||||
```
|
||||
|
||||
### Renderable Methods
|
||||
|
||||
- `add(child)`, `insertBefore(child, anchor)`, `remove(id)`, `getChildren()`
|
||||
- `focus()`, `blur()`
|
||||
- `destroy()`, `destroyRecursively()`
|
||||
- `requestRender()`
|
||||
- `calculateLayout()`
|
||||
- Getters/setters for all flex properties
|
||||
|
||||
---
|
||||
|
||||
## Components
|
||||
|
||||
### Box
|
||||
|
||||
```typescript
|
||||
interface BoxOptions extends RenderableOptions {
|
||||
backgroundColor?: string | RGBA
|
||||
borderStyle?: "single" | "double" | "rounded" | "heavy"
|
||||
border?: boolean | ("top" | "right" | "bottom" | "left")[]
|
||||
borderColor?: string | RGBA
|
||||
customBorderChars?: BorderCharacters
|
||||
shouldFill?: boolean
|
||||
title?: string
|
||||
titleAlignment?: "left" | "center" | "right"
|
||||
focusedBorderColor?: ColorInput
|
||||
focusable?: boolean
|
||||
gap?: number | `${number}%`
|
||||
rowGap?: number | `${number}%`
|
||||
columnGap?: number | `${number}%`
|
||||
}
|
||||
```
|
||||
|
||||
### Text
|
||||
|
||||
```typescript
|
||||
interface TextOptions extends TextBufferOptions {
|
||||
content?: StyledText | string
|
||||
}
|
||||
|
||||
interface TextBufferOptions extends RenderableOptions {
|
||||
fg?: string | RGBA
|
||||
bg?: string | RGBA
|
||||
selectionBg?: string | RGBA
|
||||
selectionFg?: string | RGBA
|
||||
selectable?: boolean
|
||||
attributes?: number
|
||||
wrapMode?: "none" | "char" | "word"
|
||||
tabIndicator?: string | number
|
||||
tabIndicatorColor?: string | RGBA
|
||||
truncate?: boolean
|
||||
}
|
||||
```
|
||||
|
||||
**Methods:** `content` (get/set), `add(text)`, `remove(id)`, `clear()`, `plainText` (getter), `scrollY/scrollX` (get/set), `wrapMode` (get/set)
|
||||
|
||||
### Input
|
||||
|
||||
```typescript
|
||||
interface InputRenderableOptions extends Omit<TextareaOptions, "height" | "minHeight" | "maxHeight" | "initialValue"> {
|
||||
value?: string
|
||||
maxLength?: number // default 1000
|
||||
placeholder?: string
|
||||
}
|
||||
|
||||
enum InputRenderableEvents {
|
||||
INPUT = "input"
|
||||
CHANGE = "change"
|
||||
ENTER = "enter"
|
||||
}
|
||||
```
|
||||
|
||||
**Methods:** `value` (get/set), `maxLength` (get/set), `placeholder` (get/set), `focus()`, `blur()`, `submit()`, `undo()`, `redo()`
|
||||
|
||||
### Textarea
|
||||
|
||||
```typescript
|
||||
interface TextareaOptions extends EditBufferOptions {
|
||||
initialValue?: string
|
||||
backgroundColor?: ColorInput
|
||||
textColor?: ColorInput
|
||||
focusedBackgroundColor?: ColorInput
|
||||
focusedTextColor?: ColorInput
|
||||
placeholder?: StyledText | string | null
|
||||
placeholderColor?: ColorInput
|
||||
keyBindings?: KeyBinding[]
|
||||
keyAliasMap?: KeyAliasMap
|
||||
onSubmit?: (event: SubmitEvent) => void
|
||||
}
|
||||
```
|
||||
|
||||
### Select
|
||||
|
||||
```typescript
|
||||
interface SelectOption { name: string; description: string; value?: any }
|
||||
|
||||
interface SelectRenderableOptions extends RenderableOptions {
|
||||
options?: SelectOption[]
|
||||
backgroundColor?: ColorInput
|
||||
textColor?: ColorInput
|
||||
focusedBackgroundColor?: ColorInput
|
||||
focusedTextColor?: ColorInput
|
||||
selectedBackgroundColor?: ColorInput
|
||||
selectedTextColor?: ColorInput
|
||||
descriptionColor?: ColorInput
|
||||
selectedDescriptionColor?: ColorInput
|
||||
showScrollIndicator?: boolean
|
||||
wrapSelection?: boolean
|
||||
showDescription?: boolean
|
||||
font?: ASCIIFontName
|
||||
itemSpacing?: number
|
||||
fastScrollStep?: number
|
||||
keyBindings?: SelectKeyBinding[]
|
||||
keyAliasMap?: KeyAliasMap
|
||||
}
|
||||
|
||||
enum SelectRenderableEvents {
|
||||
SELECTION_CHANGED = "selectionChanged"
|
||||
ITEM_SELECTED = "itemSelected"
|
||||
}
|
||||
```
|
||||
|
||||
**Methods:** `getSelectedOption()`, `getSelectedIndex()`, `moveUp(steps?)`, `moveDown(steps?)`, `selectCurrent()`, `setSelectedIndex(index)`, `handleKeyPress(key)`
|
||||
|
||||
### TabSelect
|
||||
|
||||
```typescript
|
||||
interface TabSelectOption { name: string; description: string; value?: any }
|
||||
|
||||
interface TabSelectRenderableOptions extends RenderableOptions {
|
||||
height?: number
|
||||
options?: TabSelectOption[]
|
||||
tabWidth?: number
|
||||
backgroundColor / textColor / focused* / selected*: ColorInput
|
||||
showScrollArrows?: boolean
|
||||
showDescription?: boolean
|
||||
showUnderline?: boolean
|
||||
wrapSelection?: boolean
|
||||
}
|
||||
|
||||
enum TabSelectRenderableEvents { SELECTION_CHANGED, ITEM_SELECTED }
|
||||
```
|
||||
|
||||
### ScrollBox
|
||||
|
||||
```typescript
|
||||
interface ScrollBoxOptions extends BoxOptions {
|
||||
rootOptions?: BoxOptions
|
||||
wrapperOptions?: BoxOptions
|
||||
viewportOptions?: BoxOptions
|
||||
contentOptions?: BoxOptions
|
||||
scrollbarOptions?: ScrollBarOptions
|
||||
verticalScrollbarOptions?: ScrollBarOptions
|
||||
horizontalScrollbarOptions?: ScrollBarOptions
|
||||
stickyScroll?: boolean
|
||||
stickyStart?: "top" | "bottom" | "left" | "right"
|
||||
scrollX?: boolean // default false
|
||||
scrollY?: boolean // default true
|
||||
scrollAcceleration?: ScrollAcceleration
|
||||
viewportCulling?: boolean // default true
|
||||
}
|
||||
```
|
||||
|
||||
**Properties:** `wrapper`, `viewport`, `content`, `scrollTop` (get/set), `scrollLeft` (get/set), `scrollWidth`, `scrollHeight`
|
||||
**Methods:** `scrollBy(delta, unit?)`, `scrollTo(position)`, `add()`, `insertBefore()`, `remove()`, `getChildren()`
|
||||
**ScrollUnit:** `"absolute" | "viewport" | "content" | "step"`
|
||||
|
||||
### ScrollBar
|
||||
|
||||
```typescript
|
||||
interface ScrollBarOptions extends RenderableOptions {
|
||||
orientation: "vertical" | "horizontal"
|
||||
showArrows?: boolean
|
||||
arrowOptions?: Omit<ArrowOptions, "direction">
|
||||
trackOptions?: Partial<SliderOptions>
|
||||
onChange?: (position: number) => void
|
||||
}
|
||||
```
|
||||
|
||||
### Slider
|
||||
|
||||
```typescript
|
||||
interface SliderOptions extends RenderableOptions {
|
||||
orientation: "vertical" | "horizontal"
|
||||
value?: number
|
||||
min?: number
|
||||
max?: number
|
||||
viewPortSize?: number
|
||||
backgroundColor?: ColorInput
|
||||
foregroundColor?: ColorInput
|
||||
onChange?: (value: number) => void
|
||||
}
|
||||
```
|
||||
|
||||
### Code
|
||||
|
||||
```typescript
|
||||
interface CodeOptions extends TextBufferOptions {
|
||||
content?: string
|
||||
filetype?: string
|
||||
syntaxStyle: SyntaxStyle // required
|
||||
treeSitterClient?: TreeSitterClient
|
||||
conceal?: boolean
|
||||
drawUnstyledText?: boolean
|
||||
streaming?: boolean
|
||||
onHighlight?: OnHighlightCallback
|
||||
}
|
||||
```
|
||||
|
||||
### Markdown
|
||||
|
||||
```typescript
|
||||
interface MarkdownOptions extends RenderableOptions {
|
||||
content?: string
|
||||
syntaxStyle: SyntaxStyle
|
||||
conceal?: boolean
|
||||
treeSitterClient?: TreeSitterClient
|
||||
streaming?: boolean
|
||||
renderNode?: (token: Token, context: RenderNodeContext) => Renderable | undefined | null
|
||||
}
|
||||
```
|
||||
|
||||
### ASCIIFont
|
||||
|
||||
```typescript
|
||||
interface ASCIIFontOptions extends RenderableOptions {
|
||||
text?: string
|
||||
font?: ASCIIFontName // e.g. "tiny"
|
||||
color?: ColorInput | ColorInput[]
|
||||
backgroundColor?: ColorInput
|
||||
selectable?: boolean
|
||||
}
|
||||
```
|
||||
|
||||
### Diff
|
||||
|
||||
```typescript
|
||||
interface DiffRenderableOptions extends RenderableOptions {
|
||||
diff?: string
|
||||
view?: "unified" | "split"
|
||||
fg?: ColorInput
|
||||
filetype?: string
|
||||
syntaxStyle?: SyntaxStyle
|
||||
wrapMode?: "none" | "char" | "word"
|
||||
showLineNumbers?: boolean
|
||||
addedBg / removedBg / contextBg: ColorInput
|
||||
addedContentBg / removedContentBg / contextContentBg: ColorInput
|
||||
}
|
||||
```
|
||||
|
||||
### FrameBuffer
|
||||
|
||||
```typescript
|
||||
interface FrameBufferOptions extends RenderableOptions {
|
||||
width: number // required
|
||||
height: number // required
|
||||
respectAlpha?: boolean
|
||||
}
|
||||
```
|
||||
|
||||
### TextTable
|
||||
|
||||
```typescript
|
||||
interface TextTableOptions extends RenderableOptions {
|
||||
content?: TextTableCellContent[][]
|
||||
wrapMode?: "none" | "char" | "word"
|
||||
columnWidthMode?: "content" | "fill"
|
||||
cellPadding?: number
|
||||
showBorders?: boolean
|
||||
border?: boolean
|
||||
outerBorder?: boolean
|
||||
borderStyle?: BorderStyle
|
||||
borderColor / borderBackgroundColor / backgroundColor: ColorInput
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Color System
|
||||
|
||||
```typescript
|
||||
type ColorInput = string | RGBA
|
||||
|
||||
class RGBA extends Float32Array {
|
||||
static fromHex(hex: string): RGBA
|
||||
static fromInts(r: number, g: number, b: number, a?: number): RGBA
|
||||
static fromValues(r: number, g: number, b: number, a?: number): RGBA
|
||||
static fromArray(arr: number[]): RGBA
|
||||
get r/g/b/a(): number
|
||||
set r/g/b/a(v: number)
|
||||
toInts(): [number, number, number, number]
|
||||
equals(other: RGBA): boolean
|
||||
}
|
||||
```
|
||||
|
||||
CSS color names (28): red, green, blue, yellow, cyan, magenta, white, black, gray, orange, pink, purple, brightRed, brightGreen, brightBlue, brightYellow, brightCyan, brightMagenta, brightWhite, etc.
|
||||
|
||||
---
|
||||
|
||||
## Styled Text
|
||||
|
||||
```typescript
|
||||
import { t, bold, italic, underline, strikethrough, dim, reverse, blink, fg, bg, link } from "@opentui/core"
|
||||
|
||||
// Tagged template
|
||||
t`${bold("Hello")} ${fg("#FF0000")("World")}`
|
||||
|
||||
// Style functions (nestable)
|
||||
bold(text)
|
||||
italic(text)
|
||||
underline(text)
|
||||
strikethrough(text)
|
||||
dim(text)
|
||||
fg(color)(text)
|
||||
bg(color)(text)
|
||||
link(url)(text)
|
||||
|
||||
// Named color functions
|
||||
red(text), green(text), blue(text), yellow(text), cyan(text), magenta(text), white(text), black(text), gray(text)
|
||||
brightRed(text), brightGreen(text), brightBlue(text), brightYellow(text), brightCyan(text), brightMagenta(text), brightWhite(text)
|
||||
bgRed(text), bgGreen(text), bgBlue(text), bgYellow(text), bgCyan(text), bgMagenta(text), bgWhite(text), bgBlack(text)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Keyboard
|
||||
|
||||
### KeyEvent
|
||||
|
||||
```typescript
|
||||
class KeyEvent {
|
||||
name: string
|
||||
ctrl: boolean
|
||||
meta: boolean
|
||||
shift: boolean
|
||||
option: boolean
|
||||
sequence: string
|
||||
raw: string
|
||||
eventType: KeyEventType
|
||||
source: "raw" | "kitty"
|
||||
preventDefault(): void
|
||||
stopPropagation(): void
|
||||
get defaultPrevented(): boolean
|
||||
get propagationStopped(): boolean
|
||||
}
|
||||
```
|
||||
|
||||
### PasteEvent
|
||||
|
||||
```typescript
|
||||
class PasteEvent {
|
||||
text: string
|
||||
preventDefault(): void
|
||||
stopPropagation(): void
|
||||
}
|
||||
```
|
||||
|
||||
### Key Binding System
|
||||
|
||||
```typescript
|
||||
interface KeyBinding<T = string> {
|
||||
name: string
|
||||
action: T
|
||||
ctrl?: boolean
|
||||
shift?: boolean
|
||||
meta?: boolean
|
||||
super?: boolean
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Animation
|
||||
|
||||
```typescript
|
||||
import { createTimeline } from "@opentui/core"
|
||||
|
||||
const tl = createTimeline({ duration?: number, loop?: boolean, autoplay?: boolean })
|
||||
|
||||
tl.add({
|
||||
targets: any,
|
||||
duration: number,
|
||||
ease?: EasingFunction,
|
||||
onUpdate?: (anim: JSAnimation) => void,
|
||||
onComplete?: () => void,
|
||||
loop?: boolean,
|
||||
alternate?: boolean,
|
||||
})
|
||||
```
|
||||
|
||||
**Easing functions:** linear, inQuad, outQuad, inOutQuad, inExpo, outExpo, inOutSine, outBounce, inBounce, outElastic, inCirc, outCirc, inOutCirc, inBack, outBack, inOutBack
|
||||
|
||||
---
|
||||
|
||||
## VNode System
|
||||
|
||||
```typescript
|
||||
import { h } from "@opentui/core"
|
||||
|
||||
// Hyperscript-style (with Proxy for method chaining)
|
||||
h(Box, { width: 100 }, h(Text, { content: "hello" }))
|
||||
|
||||
// Or use factory functions directly
|
||||
Box({ width: 100 }, Text({ content: "hello" }))
|
||||
```
|
||||
|
||||
**Functions:** `isVNode(value)`, `instantiate(vnode, ctx)`, `delegate(vnode, mapping)`, `flattenChildren(children)`
|
||||
|
||||
---
|
||||
|
||||
## Exports
|
||||
|
||||
The package re-exports from: Renderable, types, utils, buffer, text-buffer, edit-buffer, syntax-style, animation/Timeline, lib (KeyHandler, RGBA, border, etc.), renderer, renderables (all components), console, Yoga namespace.
|
||||
Reference in New Issue
Block a user