Project / infrastructure
Portable Bridge Workspace
A removable workbench with a repo hub for project status, Git pushes, and private VPS-backed development.
- Linux
- Git
- SSH
- Forgejo
- Shell scripting
This project is a portable development control plane built around a removable drive, a private VPS, and a private Git service.
The goal is practical: make the drive useful to any trusted workstation or coding agent without turning chat history, a single laptop, or a public code host into the source of truth.
What it is
A bridge workspace for project work:
- project working copies live on the removable drive
- private Git history lives on a VPS-backed forge
- public releases can still be pushed to a public code host when a repo is meant to be shared
- repo-hub provides the shared menu for status, Git pushes, and handoff decisions
- helper scripts make SSH and Git consistent across machines
- documentation travels with the drive so the workflow can be resumed later
Why it exists
The system separates three jobs that are often mixed together:
- The removable drive is the portable workbench.
- The VPS is the durable private home base.
- The public code host is for open-source or intentionally public work.
That split keeps private infrastructure private while still allowing selected projects to be published publicly.
What it does
- carries enough context for another trusted environment to understand the project layout
- keeps project sync centered on Git instead of ad hoc file copying
- supports private-only pushes to the VPS
- supports dual-push for repos that should exist privately and publicly
- exposes repo-hub as the main menu for checking status, pulling, pushing, and commit-push workflows
Repo hub
The key interface is a terminal menu that lists every project repo, shows dirty state and upstream sync, and makes push decisions explicit.
It gives a coding agent or trusted workstation one obvious first command: inspect the repo hub before deciding what to touch.
What is intentionally omitted
- server addresses
- domains
- usernames
- SSH keys, fingerprints, and secret paths
- provider account details
- recovery credentials
- exact local mount paths
Technical themes
- portable workspaces
- private Git hosting
- SSH trust boundaries
- self-hosted development infrastructure
- repo mirroring and dual-push
- documentation as operational memory