xclaude refactor with claude

CLAUDE.md

@@ -1,341 +0,0 @@
-# Linux Workspace - Project Documentation
-
-## Overview
-
-**Linux Workspace** is a comprehensive shell configuration and utility toolkit designed to quickly configure new Linux machines with development tools, environment initialization, and useful utility scripts. It provides a modular, source-able bootstrap system for both bash and fish shells.
-
-This is a **dotfiles & configuration management system** combined with a rich collection of utility scripts for system administration, development workflows, and daily convenience tasks.
-
-## Quick Start
-
-### Installation
-
-```bash
-# Clone the repository
-git clone <repository-url> ~/linux-workspace
-
-# Run the installer
-cd ~/linux-workspace
-./install.sh
-```
-
-The installer automatically:
-
-- Detects the workspace directory location
-- Adds sourcing configuration to `~/.bashrc`
-- Creates Fish shell configuration at `~/.config/fish/conf.d/lws.fish`
-
-### Manual Installation
-
-Add to your `~/.bashrc`:
-
-```bash
-source /path/to/linux-workspace/bashrc
-```
-
-## Project Structure
-
-### Root Files
-
-- [bashrc](bashrc) - Main bootstrap file that initializes the entire workspace
-- [fishrc](fishrc) - Fish shell configuration entry point
-- [functions.sh](functions.sh) - Core utility functions used throughout the system
-- [install.sh](install.sh) - Installation script for automated setup
-- [.editorconfig](.editorconfig) - EditorConfig formatting standards
-
-### Key Directories
-
-#### [bin/](bin/) - Utility Scripts & Tools (45+ scripts)
-
-Collection of executable shell and Python scripts for various tasks:
-
-**Docker & Containers:**
-
-- [dcm](bin/dcm) - Advanced Docker Compose manager with dependency and health check features
-- [docker-bridge](bin/docker-bridge), [docker-noroot](bin/docker-noroot) - Docker helpers
-
-**Development Tools:**
-
-- [gws](bin/gws) - Gradle wrapper shortcuts for Kotlin development
-- [git-dif1](bin/git-dif1), [git-swl](bin/git-swl), [git-reset-master](bin/git-reset-master) - Git workflow utilities
-
-**System Utilities:**
-
-- [network-bandwidth](bin/network-bandwidth), [myip](bin/myip), [weather](bin/weather) - System info
-- [lock-screen](bin/lock-screen), [suspend.sh](bin/suspend.sh), [battery](bin/battery) - System control
-- [cs.sh](bin/cs.sh), [cheatsheet](bin/cheatsheet) - Cheatsheet lookup tools
-
-**Cloud & Infrastructure:**
-
-- [aws-login](bin/aws-login) - AWS authentication helper
-- [vpn-home.sh](bin/vpn-home.sh) - VPN configuration
-
-**Remote Tools:**
-
-- [xmosh](bin/xmosh), [xcat](bin/xcat), [xvim](bin/xvim) - Remote execution helpers
-
-#### [rc/](rc/) - Shell Configuration Modules (23 files)
-
-Modular initialization scripts loaded during shell startup:
-
-**Core Setup:**
-
-- [01-init.fish](rc/01-init.fish) - Fish shell initialization
-- [01-path.sh](rc/01-path.sh) - PATH initialization
-- [02-aliases.sh](rc/02-aliases.sh) - Common command aliases
-- [env.sh](rc/env.sh) - Environment variables (PAGER, EDITOR, MANPAGER)
-- [bash-prompt.sh](rc/bash-prompt.sh) - Colored bash prompt
-
-**Language/Framework Initialization:**
-
-- [nvm.sh](rc/nvm.sh) - Node Version Manager
-- [pyenv.sh](rc/pyenv.sh) - Python environment manager
-- [cargo.sh](rc/cargo.sh) - Rust Cargo
-- [dotnet.sh](rc/dotnet.sh) - .NET runtime
-- [sdkman.sh](rc/sdkman.sh) - SDKMAN Java/Kotlin tooling
-- [linuxbrew.sh](rc/linuxbrew.sh) - Homebrew for Linux
-
-**Development Tools:**
-
-- [ssh-agent.sh](rc/ssh-agent.sh) - SSH agent with WSL support
-- [git-prompt.sh](rc/git-prompt.sh) - Git prompt decoration
-- [direnv.sh](rc/direnv.sh) - Directory environment switching
-- [docker.sh](rc/docker.sh) - Docker initialization
-- [kubernetes.sh](rc/kubernetes.sh) - kubectl/k8s setup
-- [claude-code.sh](rc/claude-code.sh) - Claude Code integration
-
-**Other Tools:**
-
-- [gocryptfs.sh](rc/gocryptfs.sh) - Encrypted filesystem
-- [thefuck.sh](rc/thefuck.sh) - Command correction
-- [enhancd.sh](rc/enhancd.sh) - Directory navigation enhancement
-
-#### [install/](install/) - Installation Scripts (24 files)
-
-Automated setup scripts for various tools:
-
-**Development:**
-
-- [git-prompt.sh](install/git-prompt.sh), [awscli.sh](install/awscli.sh)
-- [docker-ce.sh](install/docker-ce.sh), [docker-compose-2.sh](install/docker-compose-2.sh)
-- [go-tools.sh](install/go-tools.sh), [rust.sh](install/rust.sh)
-- [npm.sh](install/npm.sh), [uv.sh](install/uv.sh)
-
-**Services:**
-
-- [k3s.sh](install/k3s.sh) - Lightweight Kubernetes
-- [lazygit.sh](install/lazygit.sh) - Git UI
-- [syncthing.sh](install/syncthing.sh) - File synchronization
-
-**Applications:**
-
-- [packages.sh](install/packages.sh) - Debian packages
-- [sublime.sh](install/sublime.sh), [vivaldi.sh](install/vivaldi.sh)
-- [pwsh.sh](install/pwsh.sh) - PowerShell
-
-#### [scripts/](scripts/) - Helper Scripts (16 files)
-
-Administrative and one-off scripts:
-
-- [git-config.sh](scripts/git-config.sh) - Git user/email configuration
-- [bash-template.sh](scripts/bash-template.sh) - Script template
-- [gnome-configuration.sh](scripts/gnome-configuration.sh) - GNOME settings automation
-- [gradle-init-kotlin.sh](scripts/gradle-init-kotlin.sh) - Gradle Kotlin project setup
-- [update-desktop-apps.sh](scripts/update-desktop-apps.sh) - Application updates
-
-#### [doc/](doc/) - Documentation (21 files)
-
-Reference guides and cheatsheets:
-
-- [bash.md](doc/bash.md) - Bash scripting guide
-- [git.md](doc/git.md) - Git workflows
-- [vim.md](doc/vim.md) - Vim editor tips
-- [cheatsheet.md](doc/cheatsheet.md) - General commands
-- [fzf.md](doc/fzf.md) - Fuzzy finder
-- [kotlin-coding-guideline.md](doc/kotlin-coding-guideline.md) - Kotlin style guide
-- [gnome.md](doc/gnome.md) - GNOME customization
-
-#### [conf/](conf/) - Configuration Files
-
-- [gnome-shortcuts.conf](conf/gnome-shortcuts.conf) - Keyboard shortcuts
-- [gradle.properties](conf/gradle.properties) - Gradle build config
-- [wsl.conf](conf/wsl.conf) - WSL settings
-- [wg-home.conf](conf/wg-home.conf) - WireGuard VPN
-- [packages.txt](conf/packages.txt) - Recommended Debian packages
-- [applications/](conf/applications/) - Application configs
-- [dircolors/](conf/dircolors/) - Directory coloring schemes
-- [vim/](conf/vim/) - Vim configurations
-
-#### [src/](src/) - Source Projects
-
-- [battery/](src/battery/) - Python project for reading notebook battery information
-
-## Key Features
-
-### Bootstrap System
-
-- **Single-entry point**: [bashrc](bashrc) sources [functions.sh](functions.sh) and loads all `.sh` files from `rc/`
-- **Modular design**: Each tool has its own configuration file
-- **Performance optimization**: `LWS_FAST=1` environment variable for fast initialization
-- **Debug mode**: `LWS_DEBUG=1` for troubleshooting
-- **Reloadable**: `reload-workspace` alias to refresh configuration
-
-### Core Functions
-
-The [functions.sh](functions.sh) file provides essential utilities:
-
-- `append_path()`, `prepend_path()` - PATH manipulation with duplicate prevention
-- `source_directory()`, `source_directory_sh()` - Smart recursive sourcing
-- `is_fast_init()`, `is_slow_init()` - Performance-based initialization
-- `can_run()`, `is_alias()` - Command availability checks
-- `is_wsl()` - Windows Subsystem for Linux detection
-- `xlog()` - Conditional debug logging
-
-### Common Aliases
-
-Defined in [rc/02-aliases.sh](rc/02-aliases.sh):
-
-- Directory: `ll`, `la` (enhanced listing)
-- Docker: `dc` (docker-compose), `dcl` (logs)
-- Navigation: `..`, `...`, `....`, `cdd` (Downloads)
-- Time: `now`, `nowsql`, `sqldate`
-- Kubernetes: `kl`, `kld`, `klg`
-- System: `ssha` (ssh-agent)
-
-### SSH Agent Integration
-
-The [rc/ssh-agent.sh](rc/ssh-agent.sh) module provides:
-
-- **WSL-aware**: Special handling for Windows Subsystem for Linux
-- **Multi-key support**: Checks for both id_ecdsa and id_rsa
-- **Auto-start**: Automatically starts ssh-agent if not running
-- **Keychain fallback**: Uses keychain for non-WSL systems
-
-### Docker Integration
-
-The [bin/dcm](bin/dcm) script offers advanced Docker Compose management:
-
-- Service dependency tracking
-- Health check polling (HTTP, TCP, Redis, etc.)
-- Parallel builds
-- Logging filtering
-- Service startup orchestration
-
-### Gradle Integration
-
-The [bin/gws](bin/gws) tool provides shortcuts for common Gradle tasks:
-
-- Build shortcuts: `c` (clean), `b` (build), `t` (test)
-- Combined: `cb` (clean+build), `cbt` (clean+build+test)
-- Skip options: `-nd` (no detekt), `-nt` (no tests)
-- Java-specific: `jar` (shadowJar), `br` (bootRun)
-
-## Environment Variables
-
-### Core Variables
-
-- `$LWS` - Root directory of Linux Workspace
-- `$WORKSPACE` - Alias for LWS
-
-### Configuration Flags
-
-- `LWS_DEBUG=1` - Enable debug logging
-- `LWS_FAST=1` - Fast initialization (skip slow tools)
-
-### Tool Customization
-
-- `DC`, `DCF` - Docker Compose customization
-- `EDITOR` - Default text editor
-- `PAGER` - Default pager (less)
-
-## Important Commands
-
-- `reload-workspace` - Reload all configurations
-- `clws` - Change directory to workspace
-- `dcm` - Docker Compose manager
-- `gws` - Gradle wrapper shortcuts
-
-## Configuration Strategy
-
-The project uses an **environment-first** approach:
-
-1. **Staged initialization**: Tools load based on `LWS_FAST` flag
-2. **Conditional loading**: Tools only initialize if directories exist
-3. **WSL detection**: Special paths and behaviors for Windows Subsystem for Linux
-4. **Path deduplication**: Removes duplicate PATH entries
-5. **EditorConfig standardization**: Consistent coding standards
-
-## Use Cases
-
-1. **Rapid environment setup** for new Linux machines
-2. **Consistent shell configuration** across multiple systems
-3. **Development tool management** (Node, Python, Rust, Go, Java)
-4. **Docker/Kubernetes workflows** with helper utilities
-5. **Git workflow automation**
-6. **System administration** utilities and scripts
-7. **Personal workspace customization** with modular components
-
-## Customization
-
-### Adding New Modules
-
-1. Create a new `.sh` file in [rc/](rc/)
-2. Add your configuration or aliases
-3. Reload with `reload-workspace`
-
-### Adding New Scripts
-
-1. Create executable script in [bin/](bin/)
-2. Make it executable: `chmod +x bin/yourscript`
-3. Script is automatically available in PATH
-
-### Disabling Modules
-
-Move unwanted modules from [rc/](rc/) to [rc.available/](rc.available/)
-
-## Dependencies
-
-The workspace intelligently detects and initializes available tools:
-
-- **Required**: bash, git
-- **Optional**: docker, kubectl, nvm, pyenv, cargo, direnv, etc.
-- **Detection**: Each module checks for tool availability before initialization
-
-## WSL Support
-
-Special handling for Windows Subsystem for Linux:
-
-- SSH agent integration with Windows
-- Path adjustments for Windows interoperability
-- WSL-specific configurations in [conf/wsl.conf](conf/wsl.conf)
-
-## Performance
-
-- **Fast mode**: Set `LWS_FAST=1` to skip heavy initializations
-- **Lazy loading**: Tools only load when directories exist
-- **Optimized PATH**: Deduplication prevents PATH bloat
-
-## Contributing
-
-This is a personal workspace configuration, but improvements are welcome:
-
-1. Follow existing naming conventions
-2. Keep scripts modular and self-contained
-3. Test on fresh installations
-4. Document new features in appropriate [doc/](doc/) files
-
-## License
-
-Personal project - use and modify as needed for your own workspace.
-
-## Recent Changes
-
-- Installation script improvements
-- Enhanced `ll` and `la` aliases
-- SSH agent fixes for WSL
-- Fish shell integration
-- Addition of new tools (Claude Code, Gemini CLI)
-
-## Support
-
-For issues or questions, refer to the documentation in [doc/](doc/) or examine the relevant configuration files in [rc/](rc/).

bin/xclaude

@@ -0,0 +1,75 @@
+#!/usr/bin/env python3
+
+# https://code.claude.com/docs/en/settings
+
+import argparse
+import os
+import sys
+import urllib.parse
+
+env = os.environ
+
+
+def die(msg):
+    print(f"Error: {msg}", file=sys.stderr)
+    sys.exit(1)
+
+
+def validate_url(url):
+    parsed = urllib.parse.urlparse(url)
+    if parsed.scheme not in ("http", "https"):
+        die(f"invalid URL scheme '{parsed.scheme}' in --url (expected http or https)")
+
+parser = argparse.ArgumentParser(
+    prog="xclaude",
+    description="Run Claude Code with any OpenAI-compatible API backend.",
+    epilog="""\
+Environment variables (overridable by arguments):
+  CLAUDE_URL    - API base URL (e.g. https://openrouter.ai/api/v1)
+  CLAUDE_TOKEN  - API token/key
+  CLAUDE_MODEL  - model name
+
+If neither URL nor token is set, defaults to Ollama:
+  OLLAMA_HOST   - Ollama server address (default: nvidia.hell), or use --host
+  OLLAMA_MODEL  - Ollama model (default: glm-5:cloud)
+
+Any extra arguments are passed through directly to the claude CLI.
+
+Examples:
+  xclaude
+  xclaude --model qwen3-coder
+  xclaude --url https://openrouter.ai/api/v1 --token sk-XXX --model openai/gpt-4o
+""",
+    formatter_class=argparse.RawDescriptionHelpFormatter,
+)
+parser.add_argument("--url", default=env.get("CLAUDE_URL", ""))
+parser.add_argument("--token", default=env.get("CLAUDE_TOKEN", ""))
+parser.add_argument("--model", default=env.get("CLAUDE_MODEL", ""))
+parser.add_argument("--host", default=env.get("OLLAMA_HOST", "nvidia.hell"))
+args, rest = parser.parse_known_args()
+
+env["DISABLE_TELEMETRY"] = "1"
+
+is_external_api = bool(args.url or args.token)
+if is_external_api:
+    if not args.url:
+        die("no URL specified (--url or CLAUDE_URL)")
+    validate_url(args.url)
+    if not args.token:
+        die("no token specified (--token or CLAUDE_TOKEN)")
+    if not args.model:
+        die("no model specified (--model or CLAUDE_MODEL)")
+    env["ANTHROPIC_BASE_URL"] = args.url
+    env["ANTHROPIC_API_KEY"] = args.token
+    # Remove Ollama auth token if switching to external API
+    env.pop("ANTHROPIC_AUTH_TOKEN", None)
+    model = args.model
+else:
+    host = args.host
+    model = args.model or env.get("OLLAMA_MODEL", "glm-5:cloud")
+    env["ANTHROPIC_BASE_URL"] = f"http://{host}:11434"
+    env["ANTHROPIC_AUTH_TOKEN"] = "ollama"
+    env.pop("ANTHROPIC_API_KEY", None)
+
+cmd = ["claude", "--model", model] + rest
+os.execvp("claude", cmd)

fishrc

@@ -1,11 +1,3 @@
-# ~/.config/fish/config.fish
+for file in (dirname (status -f))/rc.fish/*.fish
-# echo "source $LWS/fishrc" > $__fish_config_dir/conf.d/lws.fish
+    source $file
-
+end
-# $__fish_config_dir/conf.d (by default, ~/.config/fish/conf.d/)
-# $__fish_sysconf_dir/conf.d (by default, /etc/fish/conf.d/)
-
-set -gx PAGER less
-set -g fish_prompt_pwd_dir_length 0
-
-# set -g fish_autosuggestion_enabled 0
-# fish_config theme choose "fish default"

functions.sh

@@ -1,4 +1,5 @@
 # Linux Workspace Functions
+# shellcheck shell=bash
 
 if [ -z "$time_ms" ]; then
     readonly time_ms='date +%s%3N'

install/claude-code.sh

@@ -0,0 +1,9 @@
+#!/bin/bash
+
+# https://code.claude.com/docs/en/setup
+
+set -E -o errexit -o nounset -o pipefail
+set -x
+
+curl -fsSL https://claude.ai/install.sh | bash
+

rc.fish/01-init.fish

@@ -0,0 +1,5 @@
+set -gx PAGER less
+set -g fish_prompt_pwd_dir_length 0
+
+# set -g fish_autosuggestion_enabled 0
+# fish_config theme choose "fish default"

rc/02-aliases.sh

@@ -15,6 +15,7 @@ alias clws='cd $LWS'
 alias chs=cheatsheet
 
 alias dc=docker-compose
+alias pc=podman-compose
 alias dcl='dcm logs'
 alias dcfilter="sed -r 's/^[^|]+\| //g'"
 

rc/go.sh

@@ -0,0 +1 @@
+append_path_try "$HOME/.local/go/bin"

rc/opencode.sh

@@ -0,0 +1 @@
+append_path_try "$HOME/.opencode/bin"