pgit-cli
v0.9.1
Published
Agent-visible private config tracking for Git workspaces
Maintainers
Readme
PGit CLI
Agent-visible private config tracking for Git workspaces. Keep local and agent-specific files as real repo files without committing them to shared Git history.
🌐 Explore the Interactive Landing Page & Terminal Simulation
PGit keeps local configurations, agent-specific folders (like .codex/, .claude/, .docs/, .specs/, .plans/, and .opencode/), and private notes visible to Codex, Claude Code, OpenCode, and other local tools while syncing canonical copies through a user-level private store.
Quick Start
Installation
npm install -g pgit-cliBasic Usage
Track files locally in your private store:
cd your-project
# Add files and folders to your private store
pgit add .codex/ .claude/ .opencode/ specs/Synchronize your private configs across machines/workspaces:
# Push your local updates to your private store
pgit push .
# Pull private configurations into a new workspace
pgit pull .
# Or sync only specific tracked paths
pgit push todo.md docs
pgit pull todo.md
# Check the sync status (drift)
pgit statusDevelop with Agents:
Use the AI coding agents of your choice (e.g., Codex, Claude Code, OpenCode) to implement features with your private, local context.
Clean up before Code Review:
Once feature development is done, you can drop the private files from your working tree before doing a code review or creating a PR.
pgit drop .Note: Don't worry if you accidentally try to commit directly—PGit automatically installs pre-commit and pre-push hooks to prevent your tracked private files from leaking into the shared repository.
Documentation
Comprehensive guides, architecture details, and full command references can be found in our documentation:
- 🌐 Interactive Web Landing Page
- 📖 Full Command Reference
- 🏗️ Architecture Overview
- 🔄 Legacy Workflows
- 🛠️ Troubleshooting Guide
Contributing & Security
- Contributing: Please see our Contributing Guide to get started with development, testing, and submitting pull requests.
- Security: All files stay strictly local. See Security & Privacy for more details.
System Requirements
- Node.js: 18.0.0 or higher
- Git: Must be installed and available in
PATH
License
This project is licensed under the MIT License - see the LICENSE file for details.
Made with ❤️ by developers, for developers who value privacy and clean git workflows.
