Skip to content

🚀 SPT Setup for GitHub Codespaces

⚡ Quick Setup Methods

GitHub Codespace Dev Container **

After the codespace books up, run this command:

bash
touch boot.sh && chmod +x boot.sh && vi boot.sh

Then paste in the script below and run to finish setting up SPT in Github Codespaces

bash
#!/bin/bash
# Clone the repository
echo "Cloning repository..."
git clone https://github.com/smartpointstech/spt.git

# Check if clone was successful
if [ $? -ne 0 ]; then
    echo "Error: Failed to clone repository"
    exit 1
fi

# Navigate into the cloned directory
cd spt

# Make bootstrap scripts executable
echo "Making scripts executable..."
chmod +x ./scripts/bootstrap/*.sh

# Run the codespace setup script
echo "Running codespace.sh..."
./scripts/bootstrap/codespace.sh

echo "Script completed!"

📁 What Gets Installed

your-project/
├── scripts/bootstrap/          # Setup scripts
├── agents/                     # AI agent library
├── CLAUDE.md                  # Claude development rules
└── [project files]            # Your configured environment

🎯 Available Commands

bash
cf "any task"              # General AI coordination
rf-swarm "build feature"   # Focused implementation
rf-hive "complex planning" # Multi-agent coordination
claude-monitor             # Usage tracking

🖥️ Tmux Workspace

Connect after setup:

bash
tmux attach -t workspace

Windows:

  • 0: Primary Claude workspace
  • 1: Secondary Claude workspace
  • 2: Claude monitor
  • 3: System monitor (htop)

Navigation:

  • Ctrl+b 0-3 - Switch windows
  • Ctrl+b d - Detach session
  • Ctrl+b ? - Help

💡 Quick Test

bash
# After setup and connecting to tmux:
source ~/.bashrc
cf "Hello! Show me available agents"

⚠️ Troubleshooting

Can't connect to tmux:

bash
tmux list-sessions
# If missing, run:
./scripts/bootstrap/tmux-workspace.sh
tmux attach -t workspace

Commands not found:

bash
source ~/.bashrc

🎉 You're Ready

Workflow:

  1. Setup: Use devcontainer OR run scripts/bootstrap/codespace.sh
  2. Connect: tmux attach -t workspace
  3. Build: rf-swarm "Help me build my app"

✅ Complete AI development environment
✅ Extensive agent library
✅ Monitoring tools
✅ 4-window tmux workspace

Remember: Always work inside tmux for the best experience!

Released under the MIT License.