Files

Oussama Douhou 95b6c0a53b feat: add TUI environment variables to stack deployments

- Pass TERM=xterm-256color for 256-color terminal support
- Pass COLORTERM=truecolor for 24-bit color support
- Pass LANG and LC_ALL for proper Unicode rendering
- Update ROADMAP.md with TUI feature planning and cleanup automation

2026-01-10 22:38:00 +01:00

3.2 KiB

Raw Blame History

Roadmap

Done

Multi-language UI (NL, AR, EN)
RTL support
Real-time name validation
SSE deployment progress
Dokploy orchestration
SSL certificate provisioning wait
Stack cleanup API
Auto-rollback on failure
Persistent storage volumes
Logging infrastructure (log-ingest → Loki → Grafana)
AI Stack monitoring dashboard at logs.intra.flexinit.nl
Repository consolidation (3 repos → flexinit/agent-stack)
Unified CI/CD pipeline (stack + portal images)

Next (Priority)

Automated Cleanup System (HIGH)

Issue: Disk space exhaustion on Dokploy server causes CI failures

Components:

CI workflow cleanup step - prune build cache after each build
Server-side cron job - daily Docker system prune
Disk monitoring - alert at 80% usage via Grafana
Post-deployment cleanup - remove unused resources after stack deploy

Implementation:

# CI workflows (.gitea/workflows/*.yaml)
- name: Cleanup build artifacts
  if: always()
  run: |
    docker builder prune -f --keep-storage=2GB
    docker image prune -f --filter "until=24h"

# Server cron (/etc/cron.d/docker-cleanup on 10.100.0.20)
0 4 * * * root docker system prune -f --volumes --filter "until=72h"
0 4 * * * root docker exec flexinit-runner docker builder prune -f --keep-storage=5GB

Web-based TUI Support (HIGH)

Feature: Full TUI (Terminal User Interface) support inside the web browser

Goal: Enable rich terminal UI applications (like htop, lazygit, OpenCode TUI mode) to render correctly in the browser-based terminal.

Components:

xterm.js integration with full TUI support (colors, mouse, resize)
Proper TERM environment configuration (xterm-256color)
Mouse event passthrough for TUI interactions
Font/rendering optimization for box-drawing characters
Keyboard shortcut handling (Ctrl+C, Ctrl+Z, etc.)

Technical Options:

Upgrade ttyd - Ensure latest version with full xterm.js features
Custom xterm.js wrapper - More control over terminal emulation
Gotty alternative - Consider other web terminal solutions

Use Cases:

OpenCode TUI mode in browser
lazygit, lazydocker
htop, btop system monitoring
vim/neovim with full features
Any ncurses-based application

Other Next Items

User authentication (protect deployments)
Rate limiting (prevent abuse)
Stack management UI (list/delete stacks)

Later

Unit tests for validation
Integration tests
Resource limits configuration
Custom domain support
Image versioning (semantic versions + rollback)
Auto-cleanup of abandoned stacks (inactive > 30 days)

Technical Notes

Disk Space Management

Server: 10.100.0.20 (97GB total)

Docker images: ~10GB
Containers: ~1.5GB
Volumes: ~30GB
Build cache: Up to 6GB between cleanups
Safe threshold: Keep 15GB+ free (85% max usage)

Key Infrastructure

Gitea: git.app.flexinit.nl (repo: flexinit/agent-stack)
Runner: flexinit-runner container on 10.100.0.20
Registry: git.app.flexinit.nl/flexinit/agent-stack:latest
Monitoring: logs.intra.flexinit.nl (dashboard: /d/ai-stack-overview)

3.2 KiB Raw Blame History