Workstation Setup

Automated workstation setup for Nobara 42 / Fedora — terminal, dev tools, apps, and agent system.

Features

Terminal & Shell

• Shell Environment: Zsh, Starship prompt, Atuin history, Fastfetch
• Terminal: Kitty GPU-accelerated terminal with Catppuccin theme
• Fonts: CaskaydiaCove Nerd Font
• Tmux: Multiplexer with TPM plugins, session persistence, Catppuccin theme
• Power Tools: zoxide, eza, bat, fzf, ripgrep, fd-find, lazygit, yazi

Agent System

• Agent Hub: Unified configuration for Claude Code (separate repo)
• Memory Bank System: Project context management with .memory-bank/
• Git Hooks: Auto-reminder to update Memory Bank after significant commits
• Shell Aliases: Quick commands for agent workflows (mbk, mbc, ag, cdc, etc.)
• Claude Plugins: haint-core (hooks, skills), godot-dev (GDScript patterns)

Development & Tools

• Containers: Podman & Podman Compose
• Qdrant: Vector database with auto-start systemd service
• Godot Engine: Game engine setup and configuration

Applications

• Additional Apps: Chrome, Dropbox, Discord, Obsidian, Anki, Calibre, Todoist
• OneDrive: Multi-account support via abraunegg/onedrive client
• Audio Processing: EasyEffects with pre-tuned presets
• DNS: Cloudflare Block Malware configuration
• OBS Studio: Recording and streaming software (Flatpak)
• Vietnamese Input: fcitx5-unikey for Vietnamese typing

Quick Start

# Clone the repository
git clone <repo-url> workstation-setup
cd workstation-setup

# Full installation
./setup.sh

Philosophy

• Single source of truth: The assets/ directory contains all configurations
• No backups: Running setup overwrites existing configs without creating backups
• One profile: Single, full-featured terminal configuration (no "core" vs "enhanced")
• Opinionated: Curated, clean configs with Catppuccin theming throughout

Usage

./setup.sh [OPTIONS]

Options:
  --full              Run full setup (same as default)
  --terminal          Run terminal setup only
  --agent             Run agent system setup only ⭐ NEW
  --skip-terminal     Skip terminal setup
  --skip-agent        Skip agent system setup
  --skip-qdrant       Skip Qdrant setup
  --skip-godot        Skip Godot installation
  --skip-apps         Skip additional apps
  --skip-obs          Skip OBS Studio
  --skip-easyeffects  Skip EasyEffects audio setup
  --skip-dns          Skip DNS setup
  --onedrive          Setup OneDrive (multiple accounts)
  --vietnamese        Install Vietnamese input method
  --obs               Setup OBS Studio
  --remote            Remote access (Tailscale, SSH, WoL)
  --skip-remote       Skip remote access setup
  --help              Show help message

Exclusive Mode (Run ONLY specific components):
  ./setup.sh --terminal       # ONLY run terminal setup
  ./setup.sh --agent          # ONLY setup agent system ⭐ NEW
  ./setup.sh --qdrant         # ONLY setup Qdrant
  ./setup.sh --obs            # ONLY setup OBS Studio
  ./setup.sh --dns            # ONLY setup DNS

Examples:
  ./setup.sh                  # Full installation (terminal + agent + apps)
  ./setup.sh --terminal       # Terminal setup only
  ./setup.sh --agent          # Agent system setup only
  ./setup.sh --skip-godot     # Full setup EXCEPT Godot
  ./setup.sh --obs            # OBS Studio setup only

Project Structure

.
├── setup.sh                    # Master orchestrator script
├── TERMINAL_CAPABILITIES.md    # Terminal features & shortcuts guide
├── assets/                     # Configuration data (source of truth)
│   ├── .zshrc                  # Zsh configuration
│   ├── .bashrc                 # Bash configuration
│   ├── .gitconfig              # Git configuration
│   ├── .config/                # App configs
│   │   ├── starship/           # Starship prompt config
│   │   ├── atuin/              # Atuin shell history config
│   │   ├── fastfetch/          # Fastfetch system info config
│   │   ├── kitty/              # Kitty terminal + Catppuccin theme
│   │   ├── tmux/               # Tmux + TPM plugins
│   │   └── easyeffects/        # Audio presets
│   ├── fonts/                  # CaskaydiaCove Nerd Font
│   ├── godot/                  # Godot editor settings
│   └── images/                 # Custom assets (fastfetch logo)
└── scripts/
    ├── common.sh               # Shared utilities
    ├── terminal_setup.sh       # Terminal setup (single profile)
    ├── qdrant_setup.sh         # Qdrant vector database
    ├── godot_setup.sh          # Godot Engine installation
    ├── obs_setup.sh            # OBS Studio installation
    ├── apps_setup.sh           # Chrome, Dropbox, Flatpak apps
    ├── onedrive_setup.sh       # OneDrive multi-account setup
    ├── easyeffects_setup.sh    # EasyEffects audio presets
    ├── dns_setup.sh            # DNS configuration
    ├── input_setup.sh          # Vietnamese input method
    ├── agent_setup.sh          # Agent Hub setup (clones from GitHub)
    └── remote_access_setup.sh  # Remote access (Tailscale, SSH, WoL)

What Gets Installed

Agent System Setup (agent_setup.sh)

AI agent workflow integration for Claude Code:

Agent Hub (~/Projects/agent/ — separate git repo):

• Cloned from GitHub by agent_setup.sh (not backed up in this repo)
• Memory Bank templates and project bootstrapping
• Git hooks (auto-reminder for Memory Bank updates)
• Shell aliases (mbk, mbc, ag, cdc, etc.)
• Claude plugins (haint-core, godot-dev)

Claude Integration (~/.claude/):

• MCP server configuration
• Plugin registry (marketplace + installed plugins)

Per-Project Structure (created by bootstrap):

• AGENTS.md - Shared project context (all agents)
• .memory-bank/ - Project knowledge (brief, product, context, task, architecture, tech)
• .claude/ - Claude Code config + skills
• Git post-commit hook for Memory Bank reminders

Quick Commands:

ag              # Go to Agent Hub
mbk             # Edit Memory Bank
mbc             # Quick edit context.md
mbt             # Quick edit task.md
cdc <project>   # Switch to project
ag-help         # Show all commands

Documentation:

• ~/Projects/agent/README.md - Agent Hub overview
• ~/.claude/MCP_SETUP.md - MCP server setup

Terminal Setup (terminal_setup.sh)

Single, full-featured terminal configuration:

Packages:

• zsh, git, curl, wget, util-linux-user, fastfetch
• kitty (GPU-accelerated terminal)
• podman, podman-compose
• tmux

Shell Tools:

• Starship prompt (Gruvbox theme)
• Atuin (shell history with sync)
• Zsh plugins: autosuggestions, syntax-highlighting, autocomplete

Power Tools:

• zoxide - Smart cd replacement
• eza - Modern ls with icons and git status
• bat - Cat with syntax highlighting
• fzf - Fuzzy finder with Catppuccin theme
• ripgrep - Fast grep alternative
• fd-find - Fast find alternative
• lazygit - Terminal UI for git
• yazi - Terminal file manager

Configs Installed:

• .zshrc with all tool integrations
• kitty.conf with Catppuccin Mocha theme
• tmux.conf with TPM and Catppuccin theme
• starship.toml with Gruvbox Dark theme

Aliases Available:

ls  → eza --icons              # List with icons
ll  → eza -la --icons --git    # Detailed list with git status
lt  → eza --tree               # Tree view
cat → bat                       # Syntax highlighted cat
lg  → lazygit                   # Git TUI
y   → yazi                      # File manager (cd on exit)
z   → zoxide                    # Smart directory jumping

Remote Access Setup (remote_access_setup.sh)

iPad Pro M2 as mobile workstation — remote into home PC from anywhere:

Services:

• OpenSSH server (enabled, port 22)
• Tailscale (mesh VPN — no port forwarding needed)
• Wake-on-LAN (ethtool on Realtek 2.5G, persistent via NetworkManager)
• tmux for session persistence (survives SSH disconnects)

Hardware: ASUS TUF B650M-E WIFI, Ethernet eno1

BIOS Setup (manual, one-time):

• Delete → Advanced → APM Configuration
• Restore AC Power Loss = Power On (for smart plug remote boot)
• Power On By PCI-E = Enabled (for Wake-on-LAN)

iPad Apps:

• Tailscale (free) — same account, auto-connects
• Termius (free) — SSH client + tmux for session persistence
• Working Copy ($25) — Obsidian Git sync + offline code

Usage:

# From iPad (Termius)
ssh haint@100.86.91.49     # Tailscale IP — works from anywhere
tmux new -s work           # Start persistent session
# If disconnected → reconnect SSH → tmux attach -t work

# Shutdown PC remotely when done
sudo shutdown -h now

Other Components

• Qdrant: Podman container with systemd service at http://localhost:6333
• Godot: Downloads to ~/.local/bin, creates desktop entry
• OBS Studio: Installed via Flatpak (com.obsproject.Studio)
• Apps: Chrome, Dropbox (DNF), Discord, Obsidian, Anki, Calibre, Todoist (Flatpak)
• OneDrive: Multi-account sync with systemd services
• EasyEffects: Audio presets for speakers/headsets
• DNS: Cloudflare Block Malware (1.1.1.2/1.0.0.2)
• Vietnamese Input: fcitx5-unikey (auto-configured with Super+Space trigger)

Post-Setup Steps

1. Log out and log back in (for shell change to take effect)

2. Install tmux plugins: Open tmux and press Ctrl+a then I

3. Start using power tools:

   • z learns your directories automatically
   • Ctrl+R for fuzzy history search (fzf + atuin)
   • Ctrl+T for fuzzy file search
   • Alt+C for fuzzy directory navigation

Requirements

• Nobara 42 or Fedora-based distribution
• User with sudo access
• Internet connection

Customization

To customize configs:

1. Edit files directly in assets/
2. Run ./setup.sh --terminal to apply changes

The repo is your source of truth - changes are tracked in git.

License

Personal configuration - use at your own discretion.