PathBridge - Quick Start Guides

📖 ABOUT THESE GUIDES

Each Team Brain agent has a 5-minute quick-start guide tailored to their role and workflows.

Choose your guide:

Forge (Orchestrator)
Atlas (Executor)
Clio (Linux Agent)
Nexus (Multi-Platform)
Bolt (Free Executor)

🔥 FORGE QUICK START

Role: Orchestrator / Reviewer
Time: 5 minutes
Goal: Convert paths when reviewing cross-platform code

Step 1: Installation Check

# Verify PathBridge is available
cd C:\Users\logan\OneDrive\Documents\AutoProjects\PathBridge
python pathbridge.py --version

# Expected: PathBridge 1.0.0

Step 2: First Use - Convert WSL Path from CLIO

# CLIO sent you a WSL path - convert it to Windows
python pathbridge.py "/mnt/d/BCH/src/main.py"

# Expected output:
# [OK] wsl -> windows: D:\BCH\src\main.py

Step 3: Quick Clipboard Convert

# 1. Copy a WSL path from Synapse message
# 2. Run:
python pathbridge.py --clipboard

# 3. Path is now in Windows format in your clipboard!

Step 4: Python API in Your Session

# In your Forge session
from pathbridge import PathBridge

pb = PathBridge()

# Convert path from CLIO's message
clio_path = "/mnt/d/BEACON_HQ/config.json"
windows_path = pb.convert(clio_path)
print(f"Opening: {windows_path}")
# Opening: D:\BEACON_HQ\config.json

Forge-Specific Commands

# Convert and get quiet output (for scripts)
python pathbridge.py -q "/mnt/d/project"
# D:\project

# Get all formats for a path
python pathbridge.py --info "D:\BEACON_HQ"

Next Steps for Forge

Read INTEGRATION_PLAN.md - Forge section
Try EXAMPLES.md - Example 8 (Agent Handoff)
Add alias to PowerShell profile: function pb { python C:\...\pathbridge.py $args }

⚡ ATLAS QUICK START

Role: Executor / Builder
Time: 5 minutes
Goal: Use PathBridge in tool development

Step 1: Installation Check

cd C:\Users\logan\OneDrive\Documents\AutoProjects\PathBridge
python -c "from pathbridge import PathBridge; print('OK')"
# OK

Step 2: First Use - Generate Cross-Platform Paths

# When building tools, generate paths for all platforms
from pathbridge import PathBridge

pb = PathBridge()

# Your tool's data path (defined in Windows format)
DATA_PATH = "D:\\BEACON_HQ\\data"

# Generate platform-specific versions
print(f"Windows: {pb.convert(DATA_PATH, target='windows')}")
print(f"WSL:     {pb.convert(DATA_PATH, target='wsl')}")

# Windows: D:\BEACON_HQ\data
# WSL:     /mnt/d/BEACON_HQ/data

Step 3: In Tool Build Scripts

# In your tool's __init__.py or config
from pathbridge import PathBridge
import platform

pb = PathBridge()

def get_data_path():
    """Get platform-appropriate data path."""
    base = "D:\\BEACON_HQ\\tool_data"
    if platform.system() == "Windows":
        return base
    return pb.convert(base, target="wsl")

Step 4: CLI During Development

# Quick convert while testing
python pathbridge.py "D:\test\output.json"
# /mnt/d/test/output.json

# Batch convert for config files
echo "D:\path1\nD:\path2" | python pathbridge.py -q

Atlas-Specific Commands

# Include in tool tests
python pathbridge.py --info "D:\test_data\fixture.json"

# Generate both formats for README
python pathbridge.py -q "D:\AutoProjects\MyTool" 
python pathbridge.py -q -t win "/mnt/d/AutoProjects/MyTool"

Next Steps for Atlas

Include PathBridge in tool test suites
Add platform detection to new tools
Use in Holy Grail automation scripts

🐧 CLIO QUICK START

Role: Linux / Ubuntu Agent
Time: 5 minutes
Goal: Convert Windows paths from other agents to WSL format

Step 1: Linux Installation

# Clone from GitHub
cd ~
git clone https://github.com/DonkRonk17/PathBridge.git
cd PathBridge

# Test it works
python3 pathbridge.py --version
# PathBridge 1.0.0

# Create alias (add to ~/.bashrc)
echo 'alias pb="python3 ~/PathBridge/pathbridge.py"' >> ~/.bashrc
source ~/.bashrc

Step 2: First Use - Convert Windows Path

# Forge sent you a Windows path - convert it
pb "D:\BCH\src\main.py"
# [OK] windows -> wsl: /mnt/d/BCH/src/main.py

# Quick quiet mode
pb -q "D:\BEACON_HQ\config.json"
# /mnt/d/BEACON_HQ/config.json

Step 3: Clipboard Workflow

# Install xclip for clipboard support
sudo apt install xclip

# Now clipboard mode works
pb -c  # Reads clipboard, converts, copies back

Step 4: In Shell Scripts

#!/bin/bash
# process_file.sh

# Receive Windows path from Synapse
WIN_PATH="D:\BCH\src\main.py"

# Convert to WSL
WSL_PATH=$(pb -q "$WIN_PATH")

# Use it
if [ -f "$WSL_PATH" ]; then
    cat "$WSL_PATH"
else
    echo "File not found: $WSL_PATH"
fi

Step 5: Python API

# In Python scripts
import sys
sys.path.insert(0, '/home/user/PathBridge')
from pathbridge import PathBridge

pb = PathBridge()
wsl_path = pb.convert("D:\\BCH\\config.json")
print(f"Config at: {wsl_path}")

Clio-Specific Commands

# Batch convert paths from a file
cat windows_paths.txt | pb -q > wsl_paths.txt

# Convert path before cd
cd $(pb -q "D:\BCH\src")

Next Steps for Clio

Add pb alias to ABIOS startup
Use in BCH development scripts
Test clipboard with xclip

🌐 NEXUS QUICK START

Role: Multi-Platform Agent
Time: 5 minutes
Goal: Handle paths on any platform

Step 1: Platform Detection

import platform
from pathbridge import PathBridge

pb = PathBridge()

print(f"Running on: {platform.system()}")
# Running on: Windows (or Linux, or Darwin)

# PathBridge works the same everywhere!
result = pb.convert("D:\\folder")
print(f"Converted: {result}")

Step 2: Platform-Aware Path Helper

from pathbridge import PathBridge
import platform

class UniversalPath:
    """Helper for paths that work everywhere."""
    
    def __init__(self):
        self.pb = PathBridge()
        self.is_windows = platform.system() == "Windows"
    
    def get(self, path):
        """Get path for current platform."""
        if self.is_windows:
            return self.pb.convert(path, target="windows")
        return self.pb.convert(path, target="wsl")

# Usage
paths = UniversalPath()
config = paths.get("D:\\BEACON_HQ\\config.json")
# Returns Windows path on Windows, WSL path on Linux

Step 3: Cross-Platform Script

#!/usr/bin/env python3
"""Script that works on any platform."""

from pathbridge import PathBridge
import platform

pb = PathBridge()

# Define paths in Windows format (canonical)
BEACON_HQ = "D:\\BEACON_HQ"
MEMORY_CORE = "D:\\BEACON_HQ\\MEMORY_CORE_V2"

def main():
    # Auto-convert for current platform
    beacon = pb.convert(BEACON_HQ)
    memory = pb.convert(MEMORY_CORE)
    
    print(f"Platform: {platform.system()}")
    print(f"BEACON_HQ: {beacon}")
    print(f"MEMORY_CORE: {memory}")

if __name__ == "__main__":
    main()

Platform-Specific Notes

Windows:

Paths work natively
PowerShell clipboard works

Linux:

Install xclip for clipboard: sudo apt install xclip
May need python3 instead of python

macOS:

pbcopy/pbpaste for clipboard (built-in)
/mnt/ paths don't exist (no WSL)

Next Steps for Nexus

Test on all 3 platforms
Create platform-specific aliases
Document any platform differences

🆓 BOLT QUICK START

Role: Free Executor (Cline + Grok)
Time: 5 minutes
Goal: Batch process paths without API costs

Step 1: Verify Free Access

# PathBridge has no API keys, no costs!
python pathbridge.py --version
# PathBridge 1.0.0

Step 2: Batch Processing (Bolt's Specialty)

# Create a file with many paths
cat << 'EOF' > paths.txt
D:\project1\src
D:\project2\src
D:\project3\src
C:\Users\logan\Documents
EOF

# Convert all at once (no API calls!)
cat paths.txt | python pathbridge.py -q > paths_wsl.txt

# View results
cat paths_wsl.txt
# /mnt/d/project1/src
# /mnt/d/project2/src
# /mnt/d/project3/src
# /mnt/c/Users/logan/Documents

Step 3: Bulk Operations (Save API Calls!)

# Extract paths from log and convert
grep "file:" server.log | awk '{print $2}' | python pathbridge.py -q

# Fix all paths in a JSON config
cat config.json | python pathbridge.py -q > config_fixed.json

Step 4: Quick Scripting

# process_all.py - Bolt batch processor
from pathbridge import PathBridge
import sys

pb = PathBridge()

# Read paths from stdin
for line in sys.stdin:
    path = line.strip()
    if path:
        converted = pb.convert(path)
        print(converted)

Bolt-Specific Commands

# Process entire directory listing
dir /B "D:\projects" | python pathbridge.py -q

# Convert and execute
for f in $(cat files.txt | python pathbridge.py -q); do
    process "$f"
done

Next Steps for Bolt

Add to Cline workflows
Use for bulk file processing
No API costs = unlimited conversions!

📚 ADDITIONAL RESOURCES

For All Agents:

Full Documentation: README.md
Examples: EXAMPLES.md
Integration Plan: INTEGRATION_PLAN.md
Cheat Sheet: CHEAT_SHEET.txt

Support:

GitHub Issues: https://github.com/DonkRonk17/PathBridge/issues
Synapse: Post in THE_SYNAPSE/active/
Direct: Message ATLAS

Last Updated: January 23, 2026
Maintained By: ATLAS (Team Brain)

FilesExpand file tree

QUICK_START_GUIDES.md

Latest commit

History

QUICK_START_GUIDES.md

File metadata and controls

PathBridge - Quick Start Guides

📖 ABOUT THESE GUIDES

🔥 FORGE QUICK START

Step 1: Installation Check

Step 2: First Use - Convert WSL Path from CLIO

Step 3: Quick Clipboard Convert

Step 4: Python API in Your Session

Forge-Specific Commands

Next Steps for Forge

⚡ ATLAS QUICK START

Step 1: Installation Check

Step 2: First Use - Generate Cross-Platform Paths

Step 3: In Tool Build Scripts

Step 4: CLI During Development

Atlas-Specific Commands

Next Steps for Atlas

🐧 CLIO QUICK START

Step 1: Linux Installation

Step 2: First Use - Convert Windows Path

Step 3: Clipboard Workflow

Step 4: In Shell Scripts

Step 5: Python API

Clio-Specific Commands

Next Steps for Clio

🌐 NEXUS QUICK START

Step 1: Platform Detection

Step 2: Platform-Aware Path Helper

Step 3: Cross-Platform Script

Platform-Specific Notes

Next Steps for Nexus

🆓 BOLT QUICK START

Step 1: Verify Free Access

Step 2: Batch Processing (Bolt's Specialty)

Step 3: Bulk Operations (Save API Calls!)

Step 4: Quick Scripting

Bolt-Specific Commands

Next Steps for Bolt

📚 ADDITIONAL RESOURCES