Yesman Claude

Yesman-Claude is a comprehensive workspace management server with modern Tauri desktop application. It provides session management and monitoring through a unified SvelteKit interface.

🚀 Key Features

Core Functionality

• Session Management: Create and manage tmux sessions using YAML templates
• FastAPI Backend Server: RESTful API for session and workspace management
• SvelteKit Web Interface: Modern web interface for monitoring and control
• Tauri Desktop Application: Native desktop app with system integration
• Real-time Monitoring: Live session activity tracking and health monitoring

Architecture

• Python FastAPI Server: High-performance async backend
• SvelteKit Frontend: Shared codebase for both web and desktop interfaces
• Tauri Native Wrapper: Desktop application with native system integration
• Configuration Management: Pydantic-based configuration with environment support
• Error Handling: Centralized error handling with recovery hints
• Type Safety: Full TypeScript-style type hints and validation

📊 Interface Options

🌐 Web Interface (SvelteKit)

Modern web dashboard served via FastAPI backend.

# Start API server
make run-api-server

# Start web development server
make run-web-dashboard
# Access at: http://localhost:5173

🖱️ Desktop Application (Tauri + SvelteKit)

Native desktop app with the same SvelteKit codebase as web interface.

# Start Tauri development mode
make run-tauri-dev

# Full development environment (API + Web)
make dev-dashboard

🔧 Quick Start

Installation

# Development installation (recommended)
make install-dev
# or directly:
pip install -e . --config-settings editable_mode=compat

# Install dashboard dependencies
make install-dashboard-deps

Basic Commands

# Start API server
make run-api-server
# API available at: http://localhost:10501

# Start web dashboard
make run-web-dashboard
# Access at: http://localhost:5173

# Start desktop app
make run-tauri-dev

# Check server status
make dashboard-status

# Stop all servers
make stop-servers

📋 Interface Comparison

Feature	Web	Tauri
Performance	⭐⭐⭐	⭐⭐⭐⭐
Resource Usage	⭐⭐⭐	⭐⭐⭐⭐
Cross-platform	⭐⭐⭐⭐⭐	⭐⭐⭐⭐
Remote Access	⭐⭐⭐⭐⭐	⭐
User Experience	⭐⭐⭐⭐	⭐⭐⭐⭐⭐
Customization	⭐⭐⭐⭐⭐	⭐⭐⭐⭐
System Integration	⭐⭐⭐	⭐⭐⭐⭐⭐

When to Use Each Interface

• Web: Remote monitoring, team collaboration, browser-based workflows, development
• Tauri: Daily use, best user experience, desktop integration, offline capabilities

설정 파일

글로벌 설정

글로벌 설정 파일은 다음 경로에 위치합니다:

$HOME/.scripton/yesman/yesman.yaml
$HOME/.scripton/yesman/sessions/   # Individual session files

파일 구조 examples/ 참고

템플릿 시스템

Yesman-Claude는 재사용 가능한 tmux 세션 템플릿을 지원합니다. 템플릿을 사용하면 여러 프로젝트에서 일관된 개발 환경을 쉽게 구성할 수 있습니다.

템플릿 위치

템플릿 파일은 ~/.scripton/yesman/templates/ 디렉터리에 YAML 형식으로 저장됩니다.

기본 템플릿 구조

session_name: "{{ session_name }}"
workspace_config:
  base_dir: "{{ base_dir }}"
workspace_definitions:
  main:
    rel_dir: "."
    allowed_paths: ["."]
    description: "Main project workspace"
windows:
  - window_name: main
    layout: even-horizontal
    panes:
      - shell_command: "npm run dev"

Smart Templates

"스마트 템플릿"은 조건부 명령 실행을 지원합니다:

panes:
  - shell_command: |
      # 의존성이 없거나 오래된 경우에만 설치
      if [ ! -d "node_modules" ] || [ "package.json" -nt "node_modules/.package-lock.json" ]; then
        echo "Dependencies missing or outdated, installing..."
        pnpm install
      else
        echo "Dependencies up to date, skipping install"
      fi
      pnpm dev

템플릿 사용하기

개별 세션 파일에서 템플릿을 참조하고 필요한 값을 오버라이드할 수 있습니다:

# ~/.scripton/yesman/sessions/my_project.yaml
session_name: "my_project"
template_name: "django"
override:
  session_name: my_django_app
  workspace_config:
    base_dir: "~/projects/django-app"

자세한 내용은 템플릿 문서를 참조하세요.

🏗️ Development

Architecture Overview

Yesman Claude는 현대적이고 유지보수 가능한 아키텍처로 구축되었습니다:

• FastAPI Backend: 고성능 비동기 Python 백엔드 서버
• SvelteKit Frontend: 반응형 웹 인터페이스 (Web + Tauri 공유)
• Tauri Desktop: 네이티브 데스크톱 앱 래퍼
• Configuration Management: Pydantic 스키마 기반의 검증 가능한 설정 시스템
• Error Handling: 중앙화된 에러 처리와 사용자 친화적인 복구 힌트

Quick Start for Developers

# 개발 환경 설정
git clone <repository-url>
cd yesman-claude

# API server 시작
make run-api-server

# 웹 개발 서버 시작 (다른 터미널에서)
make run-web-dashboard

# 또는 Tauri 개발 모드
make run-tauri-dev

Development Commands

# 서버 상태 확인
make dashboard-status

# 모든 서버 중지
make stop-servers

# API 서버 디버그 모드
make debug-api

# 전체 개발 환경 (API + Web)
make dev-dashboard

# 빠른 품질 검사
make quick

# 전체 품질 검사
make full

Documentation

• 📚 Developer Guide - 개발자를 위한 상세 가이드
• 🏗️ Architecture Decision Records - 아키텍처 결정 기록
• 🧪 Testing Guide - 테스트 작성 및 실행 가이드
• ⚙️ Configuration - 설정 관리 가이드

Contributing

1. Fork the repository
2. Create a feature branch: git checkout -b feature/my-feature
3. Make your changes following the Developer Guide
4. Add tests for new functionality
5. Ensure all tests pass: make test
6. Format code: make format
7. Commit changes: git commit -m 'feat: add my feature'
8. Push to the branch: git push origin feature/my-feature
9. Create a Pull Request

Project Structure

yesman-claude/
├── api/               # FastAPI backend server
├── libs/core/         # Core architecture components
│   ├── config_*.py       # Configuration management
│   └── session_manager.py # Session management
├── tauri-dashboard/   # SvelteKit frontend (Web + Tauri)
│   ├── src/routes/       # SvelteKit pages
│   ├── src/lib/          # Reusable components
│   └── src-tauri/        # Rust backend for desktop
├── tests/             # Test suites
│   ├── unit/             # Unit tests
│   └── integration/      # Integration tests
├── docs/              # Documentation
└── examples/          # Configuration examples

📄 License

MIT License - see the LICENSE file for details.